home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / qasa41.zip / QASA.DOC < prev    next >
Text File  |  1993-01-17  |  152KB  |  3,896 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.                                 Q & A Study Aid (QASA)
  19.  
  20.                                      User's Guide
  21.  
  22.                                      Version 4.1
  23.  
  24.                                    January 17, 1993
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.                                          _______
  46.                                     ____|__     |                (R)
  47.                                  --|       |    |-------------------
  48.                                    |   ____|__  |  Association of
  49.                                    |  |       |_|  Shareware
  50.                                    |__|   o   |    Professionals
  51.                                  -----|   |   |---------------------
  52.                                       |___|___|    MEMBER
  53.  
  54.  
  55.  
  56.  
  57.                                      Hal Endresen
  58.                                 Quid Pro Quo Software
  59.                                     P.O. Box 1248
  60.                              Cedar Rapids, IA 52406-1248
  61.                               CompuServe ID [73760,2032]
  62.  
  63.  
  64.  
  65.           Q&A Study Aid V4.1 User's Guide
  66.  
  67.  
  68.  
  69.                   ***** SPECIAL OFFER TO REGISTERED USERS ONLY *****
  70.  
  71.           When you register this ASP SHAREWARE product, you will receive
  72.           two special discount offers.
  73.  
  74.           The first offer is a subscription discount to SHAREWARE MAGAZINE.
  75.           You can receive a one year subscription to SHAREWARE MAGAZINE for
  76.           $12.95.
  77.  
  78.           The second offer is a FREE COMPUSERVE MEMBERSHIP, plus $15.00 of
  79.           online credit.
  80.  
  81.           These offers are available only to registered users. See page 61
  82.           for details. When you register this program, you will receive all
  83.           necessary information to take advantage of these two special
  84.           offers.
  85.  
  86.  
  87.  
  88.  
  89.                  *****    QASA CAN NOW BE REGISTERED ONLINE     *****
  90.                  ***** Registering QASA Online Using CompuServe *****
  91.  
  92.           QASA can now be registered online using CompuServe's shareware
  93.           registration service. To register single copies of QASA on
  94.           CompuServe, enter GO SWREG at the CompuServe prompt, and select
  95.           the option "Register Shareware." You will be presented with the
  96.           following menu:
  97.  
  98.                     Register Shareware
  99.  
  100.                     SEARCH BY:
  101.  
  102.                     1 Registration ID
  103.                     2 Title
  104.                     3 File Name
  105.                     4 Author's User ID
  106.                     5 Author's Name
  107.                     6 Keywords (Categories)
  108.  
  109.           Choose option "1" (Registration ID). When prompted for the ID,
  110.           enter "502" to register QASA. We will receive a registration
  111.           notification from CompuServe, and a registered copy of the latest
  112.           version of Q&A Study Aid will to you by return mail. The regis-
  113.           tration fee will be charged to your CompuServe account.
  114.  
  115.           If are registering more than one copy or wish a site license,
  116.           please use the "Register" function in the "Utilities" menu.
  117.  
  118.  
  119.  
  120.           Copyright (C) 1988-1993 Harold J. Endresen, Quid Pro Quo Software
  121.  
  122.  
  123.  
  124.           Q&A Study Aid V4.1 User's Guide                                 i
  125.  
  126.  
  127.                                   Table Of Contents
  128.                                   -----------------
  129.  
  130.           DEFINITION OF SHAREWARE . . . . . . . . . . . . . . . . . . .   1
  131.  
  132.           The Association of Shareware Professionals  . . . . . . . . .   1
  133.  
  134.           Credits . . . . . . . . . . . . . . . . . . . . . . . . . . .   2
  135.  
  136.           Introduction  . . . . . . . . . . . . . . . . . . . . . . . .   3
  137.  
  138.           Installation  . . . . . . . . . . . . . . . . . . . . . . . .   5
  139.  
  140.           Compatibility . . . . . . . . . . . . . . . . . . . . . . . .   7
  141.  
  142.           A Special Note  . . . . . . . . . . . . . . . . . . . . . . .   7
  143.  
  144.           User Interface  . . . . . . . . . . . . . . . . . . . . . . .   9
  145.  
  146.           QASA Command List . . . . . . . . . . . . . . . . . . . . . .  10
  147.  
  148.           QA Command List . . . . . . . . . . . . . . . . . . . . . . .  11
  149.  
  150.           The Command Line  . . . . . . . . . . . . . . . . . . . . . .  11
  151.  
  152.           /FL - Load A Database . . . . . . . . . . . . . . . . . . . .  11
  153.  
  154.           /FS - Save a Database . . . . . . . . . . . . . . . . . . . .  14
  155.  
  156.           /FC - Continue with a Saved Database  . . . . . . . . . . . .  15
  157.  
  158.           /FD - Shell To DOS  . . . . . . . . . . . . . . . . . . . . .  15
  159.  
  160.           /FX - Exit to DOS . . . . . . . . . . . . . . . . . . . . . .  15
  161.  
  162.           /MS - Sequential Mode . . . . . . . . . . . . . . . . . . . .  16
  163.  
  164.           /MR - Pseudorandom Mode . . . . . . . . . . . . . . . . . . .  16
  165.  
  166.           /MC - Clear . . . . . . . . . . . . . . . . . . . . . . . . .  17
  167.  
  168.           /N - Name . . . . . . . . . . . . . . . . . . . . . . . . . .  17
  169.  
  170.           /US - Set Screen Colors . . . . . . . . . . . . . . . . . . .  17
  171.  
  172.           /UM - Set Menu Selector Character . . . . . . . . . . . . . .  18
  173.  
  174.           /UP - Set Password  . . . . . . . . . . . . . . . . . . . . .  18
  175.  
  176.           /UC - Invoke QASA Compiler  . . . . . . . . . . . . . . . . .  19
  177.  
  178.  
  179.           Copyright (C) 1988-1993 Harold J. Endresen, Quid Pro Quo Software
  180.  
  181.  
  182.  
  183.           Q&A Study Aid V4.1 User's Guide                                ii
  184.  
  185.  
  186.           /UD - Decrypt Score File  . . . . . . . . . . . . . . . . . .  19
  187.  
  188.           /UE - Export Score File . . . . . . . . . . . . . . . . . . .  20
  189.  
  190.           /UR - Print Registration Form . . . . . . . . . . . . . . . .  21
  191.  
  192.           Scoring Window  . . . . . . . . . . . . . . . . . . . . . . .  21
  193.  
  194.           Answering Questions . . . . . . . . . . . . . . . . . . . . .  22
  195.  
  196.           Creating a Database . . . . . . . . . . . . . . . . . . . . .  24
  197.                Macros . . . . . . . . . . . . . . . . . . . . . . . . .  28
  198.                The QASA Database Compiler . . . . . . . . . . . . . . .  29
  199.                Using The QASA Compiler  . . . . . . . . . . . . . . . .  30
  200.                QASA Language Syntax . . . . . . . . . . . . . . . . . .  31
  201.                Terminators  . . . . . . . . . . . . . . . . . . . . . .  32
  202.                The Q= and A= Keywords . . . . . . . . . . . . . . . . .  32
  203.                The P= Keyword . . . . . . . . . . . . . . . . . . . . .  33
  204.                The N= Keyword . . . . . . . . . . . . . . . . . . . . .  34
  205.                The M= Keyword . . . . . . . . . . . . . . . . . . . . .  34
  206.                The T= Keyword . . . . . . . . . . . . . . . . . . . . .  38
  207.                The C= Keyword . . . . . . . . . . . . . . . . . . . . .  39
  208.                The S= and R= Keywords . . . . . . . . . . . . . . . . .  39
  209.                The F= Keyword . . . . . . . . . . . . . . . . . . . . .  40
  210.                The E= Keyword . . . . . . . . . . . . . . . . . . . . .  43
  211.                The D= Keyword . . . . . . . . . . . . . . . . . . . . .  43
  212.                The W= Keyword . . . . . . . . . . . . . . . . . . . . .  43
  213.                The L= Keyword . . . . . . . . . . . . . . . . . . . . .  45
  214.                The O= Keyword . . . . . . . . . . . . . . . . . . . . .  46
  215.  
  216.           Conclusion  . . . . . . . . . . . . . . . . . . . . . . . . .  46
  217.  
  218.           Appendix A: QASA Compiler Error Messages  . . . . . . . . . .  47
  219.  
  220.           Appendix B: Revision Information  . . . . . . . . . . . . . .  50
  221.  
  222.           COPYRIGHT . . . . . . . . . . . . . . . . . . . . . . . . . .  57
  223.  
  224.           DISCLAIMER - AGREEMENT  . . . . . . . . . . . . . . . . . . .  58
  225.  
  226.           REGISTRATION  . . . . . . . . . . . . . . . . . . . . . . . .  59
  227.  
  228.           SITE LICENSING  . . . . . . . . . . . . . . . . . . . . . . .  60
  229.  
  230.           SPECIAL OFFER!  . . . . . . . . . . . . . . . . . . . . . . .  61
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.           Copyright (C) 1988-1993 Harold J. Endresen, Quid Pro Quo Software
  239.  
  240.  
  241.  
  242.           Q&A Study Aid V4.1 User's Guide                                 1
  243.  
  244.  
  245.  
  246.           DEFINITION OF SHAREWARE
  247.           -----------------------
  248.  
  249.           Shareware distribution gives users a chance to try software
  250.           before buying it. If you try a Shareware program and continue
  251.           using it, you are required to register and pay for its use. With
  252.           registration, you get anything from the simple right to continue
  253.           using the software, technical support services, or an updated
  254.           program with printed manual.
  255.  
  256.           Copyright laws apply to both Shareware and commercial software,
  257.           and the copyright holder retains all rights, with a few specific
  258.           exceptions as stated below. Shareware authors are accomplished
  259.           programmers, just like the authors of commercial software, and
  260.           the programs are of comparable quality (in both cases, there are
  261.           good programs and bad ones!). The main difference is the method
  262.           of distribution. The author specifically grants you the right to
  263.           copy and distribute the software, either to all and sundry or to
  264.           a specific group. For example, some authors require written
  265.           permission before a commercial disk vendor may copy and/or
  266.           distribute their Shareware.
  267.  
  268.           Shareware is a distribution method, not a type of software. You
  269.           should find and purchase software that suits your needs and
  270.           pocketbook, whether it's commercial or Shareware. The Shareware
  271.           system is easier because you can try before you buy. Because the
  272.           overhead is low, prices are low also. Shareware has the ultimate
  273.           money-back guarantee - if you don't use the product, you don't
  274.           pay for it.
  275.  
  276.  
  277.           The Association of Shareware Professionals
  278.           ------------------------------------------
  279.  
  280.           The Association of Shareware Professionals is an organization
  281.           whose purpose is to promote the shareware distribution concept,
  282.           and to provide a forum for the resolution of disputes between ASP
  283.           members and their customers.
  284.  
  285.           Quid Pro Quo Software is a member of the Association of Shareware
  286.           Professionals (ASP).  ASP wants to make sure that the shareware
  287.           principle works for you. If you are unable to resolve a share-
  288.           ware-related problem with an ASP member by contacting the member
  289.           directly, ASP may be able to help. The ASP Ombudsman can help you
  290.           resolve a dispute or problem with an ASP member, but does not
  291.           provide technical support for members' products. Please write to
  292.           the ASP Ombudsman at 545 Grover Road, Muskegon, MI 49442-9427 or
  293.           send a Compuserve message via CompuServe Mail to ASP Ombudsman
  294.           70007,3536.
  295.  
  296.  
  297.           Copyright (C) 1988-1993 Harold J. Endresen, Quid Pro Quo Software
  298.  
  299.  
  300.  
  301.           Q&A Study Aid V4.1 User's Guide                                 2
  302.  
  303.  
  304.  
  305.           Credits
  306.           -------
  307.  
  308.           Microsoft(R), Microsoft Windows(R), MS-DOS, Microsoft C Optimiz-
  309.           ing Compiler(R), and Microsoft Macro Assembler are registered
  310.           trademarks of Microsoft Corporation.
  311.  
  312.           IBM, OS/2, and PC-DOS are registered trademarks of International
  313.           Business Machines Corporation.
  314.  
  315.           dBASE is a registered trademark of Ashton-Tate.
  316.  
  317.           RTLink/Plus is a registered trademark of Pocket Soft, Inc.
  318.  
  319.           DESQview is a registered trademark of Quarterdeck Office Systems,
  320.           Inc.
  321.  
  322.           Lotus, Lotus 1-2-3, and 1-2-3 are trademarks of Lotus Development
  323.           Corporation.
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.           Copyright (C) 1988-1993 Harold J. Endresen, Quid Pro Quo Software
  357.  
  358.  
  359.  
  360.           Q&A Study Aid V4.1 User's Guide                                 3
  361.  
  362.  
  363.           Introduction
  364.           ------------
  365.  
  366.           Q&A Study Aid is a general-purpose program designed to present
  367.           questions from a database. The user is then prompted for an
  368.           answer and graded accordingly.
  369.  
  370.           In the context of this document, and within all program and other
  371.           files included with the QASA package, the word 'database' is used
  372.           in its generic sense. For our purposes, a database is simply a
  373.           collection of questions, answers, and options that is created by
  374.           the user, compiled, and interpreted by the QASA program. Like the
  375.           more general database programs such as dBASE(R), Q&A Study Aid
  376.           uses an indexed database, although the index is an integral part
  377.           of the database itself and not a separate file. All of the
  378.           details of the database implementation, such as the index,
  379.           records, fields, and data types, are handled automatically by the
  380.           Q&A Study Aid package. You need not, therefore, be concerned with
  381.           these, or even know what they mean.
  382.  
  383.           QASA provides two methods of reading the questions from the
  384.           database: sequential and random. The program defaults to sequen-
  385.           tial mode.
  386.  
  387.           A menu-driven command interface is provided with pull-down menus.
  388.           Filenames are selected from a directory by pointing. It is never
  389.           necessary to type in a filename unless a database is specified on
  390.           the command line.
  391.  
  392.           QASA supports a comprehensive context-sensitive help system
  393.           accessible via the F1 key. Help is provided by a single file,
  394.           QASA.HLP. This file may be located in the current directory or in
  395.           any directory specified in the PATH environment variable. QASA
  396.           may therefore be placed in the \DOS (or equivalent) directory and
  397.           accessed from any other directory, provided that PATH environment
  398.           variable includes "\DOS". If you place QASA in a directory that
  399.           is not in the PATH string such that it is unable to locate its
  400.           help file, QASA will, as a last resort, pop up a window and ask
  401.           you to enter the name of directory containing the help file. If
  402.           you do not enter a directory name (by pressing RETURN at the
  403.           prompt), the Help key will be inactive.
  404.  
  405.           QASA uses a compiled database. The database compiler is included
  406.           within QASA to allow you to create and compile your own databas-
  407.           es. The database compiler is invoked via the "Utilities" menu.
  408.           The "small model" interpreter-only program, QA.EXE, does not
  409.           include the compiler or any of the other utilities provided by
  410.           QASA.EXE.
  411.  
  412.  
  413.  
  414.  
  415.           Copyright (C) 1988-1993 Harold J. Endresen, Quid Pro Quo Software
  416.  
  417.  
  418.  
  419.           Q&A Study Aid V4.1 User's Guide                                 4
  420.  
  421.  
  422.           Both QASA.EXE and QA.EXE are written in the C language (with some
  423.           assembly-language) and compiled using the Microsoft C Optimizing
  424.           Compiler Version 6.00A and the Microsoft Macro Assembler V6.0B.
  425.           Pocket Soft's RTLink/Plus overlay linker is used to generate the
  426.           executable files.
  427.  
  428.           This package contains the following files:
  429.  
  430.                QASA.EXE       QASA main program
  431.                QA.EXE         "Small Model" (database interpreter only)
  432.                QASA.HLP       QASA and QA help file
  433.                QASA.CFG       configuration file suitable for VGA monitors
  434.                QASA.DOC       documentation file (this file)
  435.  
  436.                SAMPLE.QA      sample database (compiled)
  437.                SAMPLE.DEF     database definition file for SAMPLE.QA
  438.  
  439.                VENDOR.DOC     information for disk vendors and BBS sysops
  440.                FILE_ID.DIZ    description for BBS sysops
  441.  
  442.           The Q&A Study Aid package is SHAREWARE and is copyrighted by the
  443.           author. If QASA meets your needs and you continue to use the
  444.           program, you must register and pay for its use. The SHAREWARE
  445.           concept allows users to obtain high quality software at bargain
  446.           prices, and rewards authors for their efforts. Please support
  447.           this distribution concept by registering your copy. You will find
  448.           a registration form at the back of this manual (although the /UR
  449.           command will doubtless be much more convenient). You have unlim-
  450.           ited rights to copy and distribute the program, provided you
  451.           distribute it as the complete UNMODIFIED package QASA41.ZIP. Com-
  452.           ments, bug reports, or other information that may help me improve
  453.           this program are welcome and are encouraged. Only you can tell me
  454.           what you need!
  455.  
  456.           QASA is offered as is. There is no guarantee that it will work on
  457.           your particular system; however, it has been tested with CGA,
  458.           MDA, EGA, and VGA monitors on PCs, ATs, 386 and 486 systems, and
  459.           under DOS, Windows, DESQview, and OS/2 2.0. Text mode is used; no
  460.           graphics card is needed. QASA will NOT use either EMS or XMS
  461.           memory, even if it is present. A minimum of 134K of program space
  462.           plus 28K of data space (RAM) is needed by the program; it will
  463.           tell you if you do not have sufficient memory to execute it. QASA
  464.           will use all available memory below the 640K conventional-memory
  465.           boundary if it is required.
  466.  
  467.           All I/O is performed through system calls, with the exception of
  468.           the screen, which is controlled by direct writes to the screen
  469.           buffer. Under Microsoft(R) Windows, you must give QASA control of
  470.           the screen in a QASA.PIF file. Under DESQview, QASA will multi-
  471.  
  472.  
  473.  
  474.           Copyright (C) 1988-1993 Harold J. Endresen, Quid Pro Quo Software
  475.  
  476.  
  477.  
  478.           Q&A Study Aid V4.1 User's Guide                                 5
  479.  
  480.  
  481.           task in a DESQview window, and does not require any special
  482.           system resources.
  483.  
  484.           QA.EXE will execute properly in a DOS window under OS/2 2.0.
  485.           QASA.EXE, however, will cause a sharing violation because it must
  486.           modify itself to enforce its registration policies. QASA will run
  487.           properly under OS/2 2.0 once it has been registered and a utili-
  488.           ties password has been selected under MS-DOS or PC-DOS.
  489.  
  490.           QASA assumes that your screen is set to any text mode (color or
  491.           monochrome). If not, it will NOT reset the mode. If your screen
  492.           is in any of the graphics modes when QASA is invoked, you will
  493.           see garbage. Exit QASA using the /FX command (or press ESC if you
  494.           are still in the opening screen) and reset the mode manually
  495.           using the DOS MODE command. When QASA terminates, it will restore
  496.           the previous contents of your screen.
  497.  
  498.  
  499.           Installation
  500.           ------------
  501.  
  502.           Q&A Study Aid requires no special installation other than copying
  503.           the files to a hard or floppy disk.
  504.  
  505.           The configuration file QASA.CFG is supplied with the distribution
  506.           package. This file is suitable for EGA and VGA color systems. If
  507.           you cannot read the screen, simply erase the configuration file
  508.           QASA.CFG, since it is created automatically if it is missing. If
  509.           you do this, you will get a prompt asking you for the directory
  510.           containing the configuration file, since QASA will not be able to
  511.           locate it on the disk. This prompt will appear anytime QASA is
  512.           unable to find its configuration file. If you move the file,
  513.           enter the name of the directory containing the file; otherwise,
  514.           press RETURN without entering a directory to cause QASA to create
  515.           the file. The default will be suitable for any system, including
  516.           LCD displays. You will not be required to enter a directory if
  517.           the configuration file is stored in any directory in the PATH
  518.           environment variable, or if it is in the current directory.
  519.  
  520.           If you are using a hard disk, you may place the executable files
  521.           in any directory (note that the files QA.EXE, QASA.HLP, and
  522.           QASA.CFG are considered to be part of the executable files). If
  523.           you wish to execute the program from a different directory than
  524.           the one in which the files are placed, you must include the
  525.           directory containing the executable files in the PATH environment
  526.           variable. To view the PATH, issue the MS-DOS command SET with no
  527.           arguments; all environment variables will be listed to the
  528.           screen.
  529.  
  530.  
  531.  
  532.  
  533.           Copyright (C) 1988-1993 Harold J. Endresen, Quid Pro Quo Software
  534.  
  535.  
  536.  
  537.           Q&A Study Aid V4.1 User's Guide                                 6
  538.  
  539.  
  540.           If you do not have a PATH variable, as evidenced by a line of the
  541.           form
  542.  
  543.           PATH=[list of directories]
  544.  
  545.           then you may enter one. If you have placed all executable files
  546.           in the directory C:\QASA, for example, issue the command
  547.  
  548.                SET PATH=C:\QASA <ENTER>
  549.  
  550.           Do not include any spaces after the word PATH. Also, it is unwise
  551.           to include any removable drive in the PATH, since DOS will
  552.           attempt to search the directory of that drive when you attempt to
  553.           execute QASA. If the floppy has been removed, you will constantly
  554.           get an error from DOS.
  555.  
  556.           If you wish to append a new directory, C:\QASA for example, to an
  557.           existing PATH, then simply retype your existing PATH and add the
  558.           directory to it as follows:
  559.  
  560.           You type:
  561.  
  562.                SET<ENTER>
  563.  
  564.           MS-DOS responds with (for example):
  565.  
  566.                PATH=C:\BIN
  567.                (other environment variables)
  568.  
  569.           You type:
  570.  
  571.                SET PATH=C:\BIN;C:\QASA <ENTER>
  572.  
  573.           Note the position of the semicolon - it is REQUIRED between
  574.           directory pathnames.
  575.  
  576.           Under DOS 3.30 and up, you may simplify this to:
  577.  
  578.                SET PATH=%PATH%;C\QASA <ENTER>
  579.  
  580.           You should place the 'SET PATH=xxxx' command in your AUTOEXEC.BAT
  581.           file, so that it will be set automatically whenever your system
  582.           is booted.
  583.  
  584.           The Q&A Study Aid package is small enough to be placed on a
  585.           single 5.25" 360KB diskette if desired. If your database is too
  586.           large to fit on one diskette, you may place it on a second
  587.           diskette in the B: drive if you have one. Because QASA uses
  588.           nested overlays, you may not remove the diskette that contains
  589.           the QASA.EXE file, as the program will periodically read this
  590.  
  591.  
  592.           Copyright (C) 1988-1993 Harold J. Endresen, Quid Pro Quo Software
  593.  
  594.  
  595.  
  596.           Q&A Study Aid V4.1 User's Guide                                 7
  597.  
  598.  
  599.           file to load overlays (this is NOT true of QA.EXE, which does not
  600.           use overlays).
  601.  
  602.           To create a database file, you need only a database definition
  603.           file, which you create, and the QASA.EXE program. Similarly, once
  604.           you have created a database, the only files needed to execute the
  605.           database are the compiled database file (".QA"), QASA.EXE or
  606.           QA.EXE, QASA.HLP, and QASA.CFG. If space is really at a premium,
  607.           you may omit the help file QASA.HLP, but the HELP key (F1) will
  608.           no longer function. If you do this, QASA will complain that it
  609.           cannot find the help file, and ask you to enter the directory in
  610.           which it resides. To omit it, simply press ENTER without entering
  611.           a directory.
  612.  
  613.           The QA.EXE program uses the same resource files as QASA.EXE:
  614.           QASA.HLP and QASA.CFG. If you wish to use a different configura-
  615.           tion for QA.EXE, you must install it in a different directory or
  616.           on a different drive. Then, using QASA, create the desired
  617.           configuration and exit QASA. The resulting QASA.CFG file may then
  618.           be copied to the directory or drive containing the QA.EXE pro-
  619.           gram.
  620.  
  621.           Compatibility
  622.           -------------
  623.  
  624.           The database files used by QASA 4.1 are fully source-compatible
  625.           with all previous versions, but are not binary-compatible. All
  626.           that is required is that you recompile your database files with
  627.           Version 4.1 of QASA.
  628.  
  629.                 QASA WILL NOT WORK WITH THE HERCULES GRAPHICS ADAPTER.
  630.  
  631.  
  632.           A Special Note
  633.           --------------
  634.  
  635.           Special mention is made here of a particular characteristic of
  636.           QASA. The program, to enforce its registration policies, will, at
  637.           certain times, modify its own executable image on disk. This is
  638.           brought to your attention as this behavior may trigger some
  639.           virus-protection programs. Please do not be concerned if this
  640.           occurs; this is normal behavior. You must allow QASA to modify
  641.           itself or it will not execute.
  642.  
  643.           QASA must be able to locate its own .EXE file. Under MS-DOS 3.0
  644.           and above, you should experience no problems, even if you rename
  645.           the file. However, under MS-DOS 2.x, if you rename the program,
  646.           you must specify the new program pathname using an environment
  647.           variable. For example, suppose QASA.EXE is in the directory
  648.  
  649.  
  650.  
  651.           Copyright (C) 1988-1993 Harold J. Endresen, Quid Pro Quo Software
  652.  
  653.  
  654.  
  655.           Q&A Study Aid V4.1 User's Guide                                 8
  656.  
  657.  
  658.           C:\BIN, and you rename it to QUIZ.EXE. You must then issue the
  659.           command
  660.  
  661.                SET QASA=C:\BIN\QUIZ.EXE
  662.  
  663.           You may place this command in your AUTOEXEC.BAT file if you wish.
  664.           You MUST specify the COMPLETE pathname, including the .EXE
  665.           extension. You cannot, however, change the name of the help file
  666.           QASA.HLP. The easiest way to change the program name is to use a
  667.           batch file. For example, to change the name to QUIZ, create
  668.           QUIZ.BAT as follows:
  669.  
  670.                COPY CON: QUIZ.BAT <ENTER>
  671.                QASA %1 <ENTER>
  672.                ^Z <ENTER>                         (^Z means hold down Ctrl
  673.                                                   and press 'Z')
  674.  
  675.           The '%1' will still enable you to specify the name of a database
  676.           to load automatically upon startup by typing:
  677.  
  678.                QUIZ sample
  679.  
  680.                                       IMPORTANT
  681.                                       ---------
  682.  
  683.           QASA.EXE selects a serial number and combines this with certain
  684.           system information the FIRST time it is executed. This becomes
  685.           your serial number, and this number MUST be supplied to register
  686.           the program (the /UR command prints the registration form with
  687.           the serial number on it). ONCE THE SERIAL NUMBER HAS BEEN AS-
  688.           SIGNED BY QASA, DO NOT MODIFY OR OVERWRITE THE QASA.EXE FILE OR
  689.           YOUR REGISTRATION NUMBER WILL NOT WORK. If you accidentally
  690.           overwrite a registered program file, you will have to send for a
  691.           new registration number (although once you have paid the regis-
  692.           tration fee, new registration numbers are supplied free of charge
  693.           if they are needed). It is a good idea to make a backup copy
  694.           after you have executed it the first time, and again after
  695.           registering your copy. Once you have registered and entered your
  696.           registration number, the serial number will change; for this
  697.           reason, it is important that you include the most recent serial
  698.           number in all correspondence. This applies ONLY to the file
  699.           QASA.EXE.
  700.  
  701.           QASA also requires that the time and date provided by the MS-DOS
  702.           operating system be correct, since it uses this information in
  703.           the score file. When QASA is started, the current time and date
  704.           are checked; if either is invalid, QASA will abort after display-
  705.           ing a message requesting you to set the system date and time to
  706.           the proper values.
  707.  
  708.  
  709.  
  710.           Copyright (C) 1988-1993 Harold J. Endresen, Quid Pro Quo Software
  711.  
  712.  
  713.  
  714.           Q&A Study Aid V4.1 User's Guide                                 9
  715.  
  716.  
  717.           QASA NEVER modifies any file other than its own executable image
  718.           on disk, the score file (if defined in the database), the saved
  719.           database file(s) (".SAV") if this feature is used, and the
  720.           configuration file. It will also create a ".QA" file each time
  721.           you compile a new quiz, and it will create a ".PRN" file is you
  722.           export the score file. You need not be concerned about modifica-
  723.           tions to your database source files or any other files on your
  724.           system.
  725.  
  726.  
  727.           User Interface
  728.           --------------
  729.  
  730.           The following applies to both QASA.EXE and QA.EXE.
  731.  
  732.           Commands are entered into QASA via a pull-down two-level menu
  733.           system. The uppermost screen region is the menu system. Each word
  734.           group on the menu line is the title block of a pull-down menu.
  735.           Whenever one of the titles is selected, the menu expands to
  736.           display any options available under it.
  737.  
  738.           Under most conditions, QASA will be prompting for an answer to a
  739.           question. Some means must therefore be provided to break out and
  740.           into the menu system so that an option can be selected or a
  741.           command given. There are two ways of doing this: via an ALT key
  742.           sequence or by pressing the menu selector character, the forward
  743.           slash ('/'). Note that this character may be changed using the
  744.           /UM (Utilities/Menu Selector) command. This document will,
  745.           however, assume that you have NOT altered the default.
  746.  
  747.           If an ALT sequence is used, it is only necessary to press one or
  748.           two ALT keys to select any command option. A top-level selector
  749.           is specified by ALT-shifting the highlighted letter. For example,
  750.           the "Mode / Sequential" command is executed with ALT-M/ALT-S. To
  751.           do this, hold down the ALT key and press 'M' and then 'S'.
  752.  
  753.           If you use the '/' menu selector character, the word MENU will
  754.           first appear at the right of the menu line to indicate that you
  755.           are in the menu system. At this point, any combination of high-
  756.           lighted and underscored letters (as defined by the screen colors
  757.           you choose) and cursor keys can be used to select a menu title
  758.           block. Note that F1 will always get help no matter where you may
  759.           be, in or out of the menu system. The only exception to this is
  760.           for error messages ("Problem"), for which you may not obtain
  761.           help. Once the desired option has been selected, RETURN executes
  762.           it. Note that neither the slash nor the RETURN are necessary when
  763.           using ALT-key sequences.
  764.  
  765.           Versions 3.0 of QASA and above provide the ability for you to
  766.           specify a database file on the command line. If you do so, you
  767.  
  768.  
  769.           Copyright (C) 1988-1993 Harold J. Endresen, Quid Pro Quo Software
  770.  
  771.  
  772.  
  773.           Q&A Study Aid V4.1 User's Guide                                10
  774.  
  775.  
  776.           will still see the opening screen, but as soon as you press a
  777.           key, the database will be loaded and the first question will be
  778.           displayed. If the database specifies a time limit, the timer will
  779.           be started immediately.
  780.  
  781.           If the database you specify cannot be found, then an error
  782.           message will be displayed, and you must select the database
  783.           normally using the /FL command. For example, the DOS command
  784.  
  785.                C>QASA sample
  786.  
  787.           will load the sample database and display the first question.
  788.           Note that you do not have to specify the ".QA" extension. If you
  789.           do specify an extension, it MUST be ".QA"; QASA will force this
  790.           extension for all database files.
  791.  
  792.           QASA's menu system commands are listed on the following page.
  793.  
  794.  
  795.           QASA Command List
  796.           -----------------
  797.  
  798.                /FL       load a database
  799.                /FS       save a database for later resumption
  800.                /FC       continue with a previously-saved database
  801.                /FD       shell to DOS
  802.                /FX       exit to DOS
  803.  
  804.                /MS       set mode to sequential
  805.                /MR       set mode to pseudorandom
  806.                /MC       clear score and start quiz over
  807.  
  808.                /N        enter name
  809.  
  810.                /US       set screen colors
  811.                /UM       set menu selector character
  812.                /UP       set password
  813.                /UC       invoke database compiler
  814.                /UD       decrypt a score file to plain text
  815.                /UE       export a score file
  816.                /UR       print registration form (appears only if the pro-
  817.                          gram copy is unregistered)
  818.  
  819.  
  820.  
  821.  
  822.  
  823.  
  824.  
  825.  
  826.  
  827.  
  828.           Copyright (C) 1988-1993 Harold J. Endresen, Quid Pro Quo Software
  829.  
  830.  
  831.  
  832.           Q&A Study Aid V4.1 User's Guide                                11
  833.  
  834.  
  835.           QA Command List
  836.           ---------------
  837.  
  838.                /FL       load a database
  839.                /FS       save a database for later resumption
  840.                /FC       continue with a previously-saved database
  841.                /FX       exit to DOS
  842.  
  843.           The Command Line
  844.           ----------------
  845.  
  846.           QASA and QA do not require any command-line parameters or argu-
  847.           ments. They will, however, allow you to specify the name of a
  848.           database file on the command line so that the program may be
  849.           invoked from a batch file.
  850.  
  851.           If you specify the name of a database file on the command line,
  852.           you do not have to enter the extension. QASA will change the
  853.           extension as required, and add one if it is omitted. For example,
  854.           to start QASA using the sample database provided, you simply type
  855.  
  856.                QASA SAMPLE <ENTER>
  857.  
  858.           or
  859.  
  860.                QA SAMPLE <ENTER>
  861.  
  862.           The opening screen will be displayed normally, but once you press
  863.           ENTER, the database file SAMPLE will be automatically loaded.
  864.  
  865.           If you specify the name of a database to the QA.EXE program, then
  866.           the program will automatically terminate when the database
  867.           execution has been completed.
  868.  
  869.  
  870.           /FL - Load A Database
  871.           ---------------------
  872.  
  873.           When you issue this command, QASA or QA will display the name of
  874.           the directory you started the program from; e.g., the current
  875.           working directory. If your database files are located in this
  876.           directory, simply press RETURN to accept the default name. If
  877.           your database files are located in another directory, you may
  878.           edit the directory name. QASA/QA will remember the new directory
  879.           name and present it as the default the next time you use this
  880.           command.
  881.  
  882.           When specifying the directory, you may select a different disk
  883.           drive followed by the path name to the database files in conven-
  884.           tional DOS form:
  885.  
  886.  
  887.           Copyright (C) 1988-1993 Harold J. Endresen, Quid Pro Quo Software
  888.  
  889.  
  890.  
  891.           Q&A Study Aid V4.1 User's Guide                                12
  892.  
  893.  
  894.                D:\DIR\DIR.....
  895.  
  896.           If you clear the name of the directory by using the backspace key
  897.           or by using the HOME key followed by Ctrl-End, QASA/QA will
  898.           automatically insert the name of the current working directory
  899.           after you press RETURN. Note that you will not see this occur as
  900.           the window will be closed as soon as you press RETURN. However,
  901.           the directory shown the next time you invoke the /FL command will
  902.           be the current working directory again.
  903.  
  904.           If you enter a drive or directory that does not exist, you will
  905.           receive an error message and you must enter the command again to
  906.           specify the proper directory. If you enter the drive identifier
  907.           of a floppy disk drive, and the drive door is open, you will
  908.           receive an error, and you will be given the opportunity to close
  909.           the drive door and retry the command.
  910.  
  911.           Note:     Certain DOS configurations can cause apparent errors
  912.                     that QASA or QA cannot detect. If, for example, you
  913.                     have installed a 'foreign' disk drive using the command
  914.                     "DEVICE=DRIVER.SYS <parameters>" and reassigned the
  915.                     name of a diskette drive using the DRIVPARM command in
  916.                     your CONFIG.SYS file (MS-DOS and PC-DOS 3.30 and later
  917.                     only), and you enter the original drive letter, QASA
  918.                     and QA will appear to hang. Actually, what is happening
  919.                     is that DOS wants you insert the diskette for the drive
  920.                     you have reassigned it to, although you will not see
  921.                     the message DOS normally displays. All that is neces-
  922.                     sary is for you to press the RETURN key.
  923.  
  924.           Once you have entered the name of the directory containing your
  925.           database files, QASA/QA will pop up a window to allow you to
  926.           select from the compiled database files available in that direc-
  927.           tory. If there are no database files in the directory, QASA/QA
  928.           will display "[ empty ]". QASA/QA will NOT display any files
  929.           other than compiled database files.
  930.  
  931.           To select a compiled database file, move the selection bar to it
  932.           using the cursor keys, PgUp and PgDn, or Home and End. Each of
  933.           these permits traveling up and down the scrollable list in larger
  934.           increments. Alternatively, you may also press a letter key that
  935.           corresponds to the first character of the database filename;
  936.           QASA/QA will find the first file beginning with that letter.
  937.           Successive depressions of the same key will step to each database
  938.           name that begins with that letter. The search stops at the last
  939.           file that begins with that letter. The search always proceeds
  940.           down the list; to restart the search, press HOME to move the
  941.           selector back to the first file in the list.
  942.  
  943.  
  944.  
  945.  
  946.           Copyright (C) 1988-1993 Harold J. Endresen, Quid Pro Quo Software
  947.  
  948.  
  949.  
  950.           Q&A Study Aid V4.1 User's Guide                                13
  951.  
  952.  
  953.           Once you have pointed to the file you desire, press RETURN. The
  954.           compiled database file will be loaded. If the optional score
  955.           logging has been enabled in the database, QASA/QA will request
  956.           that you enter your name for the score file (you may not proceed
  957.           until you have done so, although you may abort the command at
  958.           this point by pressing ESC). The first question will then appear
  959.           on the screen, along with the number of questions in the database
  960.           in the scoring window. The name of the database will also be
  961.           shown in the center of the top border of the question window if
  962.           it has been specified in the database. If no title was specified,
  963.           then the window title will default to "Question".
  964.  
  965.           Note:     When you load a database file that specifies a score
  966.                     file name, and that score file already exists, QASA and
  967.                     QA will check to insure that the encryption modes are
  968.                     compatible. If not, they will display an error message
  969.                     and override the encryption setting in the database
  970.                     file you loaded.
  971.  
  972.                     For example, if you create two separate databases, both
  973.                     of which specify the same name for the score file, but
  974.                     only one has score file encryption enabled, you will
  975.                     receive an error when you load the second database, no
  976.                     matter which one you load first. The order will affect
  977.                     only the encryption of the score file, which is deter-
  978.                     mined by the first database loaded. If you always use a
  979.                     different score file for each database, or are consis-
  980.                     tent with score file encryption, you should experience
  981.                     no problems. Note that QASA and QA will still function
  982.                     properly, however.
  983.  
  984.           Each time you load a database file with score file logging
  985.           enabled, QASA/QA will request your name, even if you have already
  986.           entered it. This is to allow other users to reload the same
  987.           database without using the same name for all users. If score file
  988.           logging is not enabled, QASA/QA doesn't force you to enter your
  989.           name. You may do this anyway with QASA if you wish, using the /N
  990.           (Name) command, and QASA will politely display it when it dis-
  991.           plays your final score.
  992.  
  993.           If the database you load has a time limit associated with it, the
  994.           time remaining will be displayed in the status window under the
  995.           heading 'Time Left', and the clock will start. The time is
  996.           counted down to zero, and always shows the time you have remain-
  997.           ing before QASA/QA stops you and calculates your final score. If
  998.           the database does not specify a time limit, the 'Time Left' field
  999.           will not be displayed. If you allow the time to count down to
  1000.           zero, it will change to 'Time Out'.
  1001.  
  1002.  
  1003.  
  1004.  
  1005.           Copyright (C) 1988-1993 Harold J. Endresen, Quid Pro Quo Software
  1006.  
  1007.  
  1008.  
  1009.           Q&A Study Aid V4.1 User's Guide                                14
  1010.  
  1011.  
  1012.           Note:     If you press the help key while a timed database is
  1013.                     loaded, the time display will not be updated until you
  1014.                     exit the help system. QASA/QA will, however, internally
  1015.                     track the remaining time. You may NOT extend the time
  1016.                     by using help.
  1017.  
  1018.           To permit QASA/QA to utilize relatively large databases (~40,000
  1019.           questions and their answers in a 640K system), QASA and QA load
  1020.           an index into memory rather than the database file itself. The
  1021.           database index is created by QASA in the form of a header in the
  1022.           database file itself. Note that this is also true of the help
  1023.           file to minimize the memory used by QASA and QA.
  1024.  
  1025.           The database file (.QA) should never be changed directly, as it
  1026.           is encrypted to prevent users from copying the file to the screen
  1027.           or a printer and thereby viewing the answers. If you wish to
  1028.           create a new database or alter an existing one, you must edit the
  1029.           database definition file (.DEF) and recompile it using QASA. QASA
  1030.           will create a (.QA) file from your (.DEF) file. QASA will not
  1031.           permit you to use the .QA extension on a definition file, so you
  1032.           cannot accidentally overwrite a compiled database.
  1033.  
  1034.           You must create the database definition file and compile it
  1035.           before QASA or QA can be used. Instructions for doing this are in
  1036.           a later section of this guide. Note that this package contains a
  1037.           compiled database that you may use to test and evaluate QASA and
  1038.           QA. This file is called SAMPLE.QA. The database definition file
  1039.           it was created from is also included, and is called SAMPLE.DEF.
  1040.  
  1041.  
  1042.           /FS - Save a Database
  1043.           ---------------------
  1044.  
  1045.           This command will save the present state of a database so that
  1046.           you may return and continue with it later. IT WILL NOT WORK IF
  1047.           THE DATABASE HAS A TIME LIMIT ASSOCIATED WITH IT.
  1048.  
  1049.           If you issue this command on a database that has no time limit,
  1050.           the state of the database will be saved in a file in the current
  1051.           directory with the same base name as the database, but with an
  1052.           extension of ".SAV". You may have different .SAV files in differ-
  1053.           ent directories for the same database if you wish.
  1054.  
  1055.           Note:     If you issue this command or the /FL (File/Load Data-
  1056.                     base) command, any existing .SAV file for that database
  1057.                     will be erased from the current working directory of
  1058.                     the disk, and you will not be able to resume it. The
  1059.                     /FL command, by definition, specifies that you wish to
  1060.                     restart the database from the beginning.
  1061.  
  1062.  
  1063.  
  1064.           Copyright (C) 1988-1993 Harold J. Endresen, Quid Pro Quo Software
  1065.  
  1066.  
  1067.  
  1068.           Q&A Study Aid V4.1 User's Guide                                15
  1069.  
  1070.  
  1071.           Once you issue the /FS command, the database will be saved and
  1072.           you will be returned to the main screen so that you may execute
  1073.           another command.
  1074.  
  1075.  
  1076.           /FC - Continue with a Saved Database
  1077.           ------------------------------------
  1078.  
  1079.           This command will allow you to resume a database which was
  1080.           previously saved using the /FS (File/Save Database) command. It
  1081.           works exactly like the /FL (File/Load) command, except that the
  1082.           list of files displayed will have an extension of ".SAV" instead
  1083.           of ".QA". If no database file has been saved, "[ empty ]" will be
  1084.           displayed.
  1085.  
  1086.           When this command is used, the previous state of the database is
  1087.           restored. The question that was on the screen will be redis-
  1088.           played, and the scoring window will reflect the previous state of
  1089.           the database.
  1090.  
  1091.           Note that once you have completed a quiz or test database, any
  1092.           .SAV file in the directory from which the database was originally
  1093.           loaded will be erased. You cannot, therefore, resume a completed
  1094.           database.
  1095.  
  1096.  
  1097.           /FD - Shell To DOS
  1098.           ------------------
  1099.  
  1100.           This command may be used to invoke a secondary copy of the DOS
  1101.           command processor COMMAND.COM (or whatever file is specified by
  1102.           the "SHELL=" environment variable). QASA will remain loaded. Note
  1103.           that this command will NOT work if a database is currently loaded
  1104.           (you will receive an error message). This command is not avail-
  1105.           able in QA.EXE.
  1106.  
  1107.           Once DOS has been invoked, you may execute any commands you wish,
  1108.           although you will have less memory available. When you wish to
  1109.           return to QASA, type 'EXIT' at the DOS prompt. The previous state
  1110.           of QASA will be restored to the screen.
  1111.  
  1112.  
  1113.           /FX - Exit to DOS
  1114.           -----------------
  1115.  
  1116.           Use this command to quit a QASA/QA session and return to DOS. If
  1117.           you have loaded a database but have not answered all questions,
  1118.           the score file will be updated with your current score and a
  1119.           notation that you quit QASA/QA. You cannot exit QASA/QA, clear
  1120.           the database, or reload the current or new database without
  1121.  
  1122.  
  1123.           Copyright (C) 1988-1993 Harold J. Endresen, Quid Pro Quo Software
  1124.  
  1125.  
  1126.  
  1127.           Q&A Study Aid V4.1 User's Guide                                16
  1128.  
  1129.  
  1130.           updating your score file. This prevents extending time limits
  1131.           and/or starting a quiz over again without any knowledge by the
  1132.           administrator that such an event occurred.
  1133.  
  1134.           Also, when you quit a QASA/QA session using this command, any
  1135.           saved database file of the same name is erased from disk, pre-
  1136.           venting resumption if the database had been previously saved. As
  1137.           a general rule, whenever your final score is displayed (and
  1138.           optionally, the score file is updated), or whenever you load a
  1139.           database using the /FL (File/Load Database) command, any associ-
  1140.           ated .SAV file will be erased.
  1141.  
  1142.           Note:     Pressing Control-C or Control-Break is interpreted the
  1143.                     same as /FX without the RETURN. Simply press RETURN to
  1144.                     update the score file and return to DOS.
  1145.  
  1146.  
  1147.           /MS - Sequential Mode
  1148.           ---------------------
  1149.  
  1150.           The sequential mode option (QASA only) tells QASA that you wish
  1151.           to answer the questions in the same order as they appear in the
  1152.           database file (this is the default). When selected, the new mode
  1153.           will appear in the scoring window. This option does NOT cause
  1154.           QASA to start reading from the beginning of the file; it simply
  1155.           changes the method used to determine the next question. Sequen-
  1156.           tial mode reads the questions from the database in a circular
  1157.           fashion until all questions have been answered. This allows
  1158.           switching between modes. QASA will not present a question again
  1159.           once it has been answered.
  1160.  
  1161.           When all questions have been answered, QASA will update the
  1162.           optional score file and display the final score.
  1163.  
  1164.           Note that this command may be locked out by an option given in
  1165.           the database definition file. If this is the case, the command
  1166.           will simply be ignored. No warning will be given indicating that
  1167.           the command is locked out.
  1168.  
  1169.  
  1170.           /MR - Pseudorandom Mode
  1171.           -----------------------
  1172.  
  1173.           This mode is used when you want QASA to choose the questions at
  1174.           random. The pseudorandom number sequence is different each time
  1175.           the program is run. This command is available in QASA only.
  1176.  
  1177.           In this mode, QASA will select the next question at random from
  1178.           the set of unanswered questions. It will not, therefore, ask a
  1179.           question again once it has been answered.
  1180.  
  1181.  
  1182.           Copyright (C) 1988-1993 Harold J. Endresen, Quid Pro Quo Software
  1183.  
  1184.  
  1185.  
  1186.           Q&A Study Aid V4.1 User's Guide                                17
  1187.  
  1188.  
  1189.           When all questions have been answered, QASA will update the
  1190.           optional score file and display the final score.
  1191.  
  1192.           Note that this command may be locked out by an option given in
  1193.           the database definition file. If this is the case, the command
  1194.           will simply be ignored. No warning will be given indicating that
  1195.           the command is locked out.
  1196.  
  1197.  
  1198.           /MC - Clear
  1199.           -----------
  1200.  
  1201.           Use the Clear option (QASA only) to reset your score back to zero
  1202.           and to reset the question index back to the beginning of the
  1203.           file. The question index is cleared only by using this command or
  1204.           by loading a new database. If you use this command, a record will
  1205.           be written to the score file indicating that the database was
  1206.           started over.
  1207.  
  1208.           Note that this command may be locked out by an option given in
  1209.           the database definition file. If this is the case, the command
  1210.           will simply be ignored. No warning will be given indicating that
  1211.           the command is locked out.
  1212.  
  1213.  
  1214.           /N - Name
  1215.           ---------
  1216.  
  1217.           This command (QASA only) is used to enter your name, which is
  1218.           placed into the score file and also displayed when the quiz
  1219.           session is completed or otherwise terminated.
  1220.  
  1221.           When this command is given, a data entry window will pop up and
  1222.           prompt for your name and/or any other identifying information.
  1223.           You may enter up to 35 characters.
  1224.  
  1225.           If a database is loaded that specifies a score file, this command
  1226.           will not work. In this case, you will be prompted to enter your
  1227.           name when the database is loaded; you may not change it until the
  1228.           database has been completed or aborted.
  1229.  
  1230.  
  1231.           /US - Set Screen Colors
  1232.           -----------------------
  1233.  
  1234.           This command (QASA only) is used to modify the screen colors. A
  1235.           color map of all possible color is displayed, along with a
  1236.           simulated menu window. A title bar at the top of the screen
  1237.           specifies which portion of the screen you are modifying. All
  1238.           color selections are performed by using the cursor keys to point
  1239.  
  1240.  
  1241.           Copyright (C) 1988-1993 Harold J. Endresen, Quid Pro Quo Software
  1242.  
  1243.  
  1244.  
  1245.           Q&A Study Aid V4.1 User's Guide                                18
  1246.  
  1247.  
  1248.           to the desired color. The PgUp and PgDn keys are used to alter
  1249.           the title bar, thereby changing the item whose color is to be
  1250.           modified. The simulated menu will change with each color change
  1251.           so that you may see the effect of the changes.
  1252.  
  1253.           Once you have set the colors as you wish, press ENTER to save the
  1254.           new colors in the configuration file, or ESCape to cancel the
  1255.           changes. For the full effect of the changes to be seen, you must
  1256.           quit QASA and then restart it so that it will redraw all screens
  1257.           using the new color set.
  1258.  
  1259.  
  1260.           /UM - Set Menu Selector Character
  1261.           ---------------------------------
  1262.  
  1263.           QASA and QA use a specific character to escape (out of an answer
  1264.           prompt if displayed) and into the menu system. This character
  1265.           defaults to the forward slash ('/'), but you may change it to any
  1266.           character you wish in the printable ASCII range of '!' through
  1267.           '~', inclusive. Once you change it, it is saved in the configura-
  1268.           tion file and will therefore be set each time you start QASA or
  1269.           QA. If you change your mind, you can reset the character or press
  1270.           ESCape to cancel the command if you have not yet pressed the
  1271.           ENTER key. The current menu selector character is always dis-
  1272.           played at the bottom of the question/answer window. This command
  1273.           is not available with QA.EXE.
  1274.  
  1275.  
  1276.           /UP - Set Password
  1277.           ------------------
  1278.  
  1279.           This command (QASA only) is used to set or change the password
  1280.           that allows access to the compiler, score file decoder, and the
  1281.           score file export commands. It cannot be used if QASA is execut-
  1282.           ing under OS/2. You must do this while running under MS-DOS or
  1283.           PC-DOS or by using the 'load specific DOS version' feature of
  1284.           OS/2 2.0.
  1285.  
  1286.           QASA is distributed with no password. Anyone may therefore use
  1287.           the password-protected commands until and unless a password is
  1288.           entered using this command.
  1289.  
  1290.           When this command is selected, if there is a password, you will
  1291.           be asked to enter it. You cannot change a password unless you
  1292.           know the current password. The password may be any series of
  1293.           characters in the range of space through a tilde ('~'), inclu-
  1294.           sive, and may contain up to 19 characters.
  1295.  
  1296.           If there is no current password, you will not be asked to enter
  1297.           it.
  1298.  
  1299.  
  1300.           Copyright (C) 1988-1993 Harold J. Endresen, Quid Pro Quo Software
  1301.  
  1302.  
  1303.  
  1304.           Q&A Study Aid V4.1 User's Guide                                19
  1305.  
  1306.  
  1307.           Once you have entered the current password, if any, you will be
  1308.           asked to enter the new password. Once you have done this, you
  1309.           will be prompted to confirm it. If the two passwords match, the
  1310.           new password will be encrypted and stored. Any attempt to identi-
  1311.           fy or modify the password will render QASA useless; it will no
  1312.           longer execute.
  1313.  
  1314.           Note that once a valid password has been entered, QASA is 'un-
  1315.           locked', and you will not be required to enter the password again
  1316.           for any function.
  1317.  
  1318.  
  1319.           /UC - Invoke QASA Compiler
  1320.           ---------------------------
  1321.  
  1322.           This command (QASA only) is used to compile a database definition
  1323.           file into a compiled database file that may be executed by QASA.
  1324.           This command is password-protected, and cannot be executed while
  1325.           a database is loaded even if you know the password.
  1326.  
  1327.           See the section entitled "Using the QASA Compiler" on page 30 for
  1328.           a full explanation on invoking and using the compiler.
  1329.  
  1330.  
  1331.           /UD - Decrypt Score File
  1332.           ------------------------
  1333.  
  1334.           This command (QASA only) is used to decrypt a score file. It is
  1335.           password-protected.
  1336.  
  1337.           It will pop up a directory window so that you may enter the
  1338.           directory containing the score file to decrypt, or you may accept
  1339.           the directory shown by pressing ENTER. Once you have selected the
  1340.           directory, a file-selection window will be displayed so that you
  1341.           may select the score file to decrypt.
  1342.  
  1343.           Once you select a score file, the file will be converted to plain
  1344.           ASCII text. If the file is not encrypted, you will receive an
  1345.           error message.
  1346.  
  1347.           The decrypted score file replaces the original file. All score
  1348.           files are named using the base score file name defined in the
  1349.           database definition file, with an extension of ".SCR".
  1350.  
  1351.  
  1352.  
  1353.  
  1354.  
  1355.  
  1356.  
  1357.  
  1358.  
  1359.           Copyright (C) 1988-1993 Harold J. Endresen, Quid Pro Quo Software
  1360.  
  1361.  
  1362.  
  1363.           Q&A Study Aid V4.1 User's Guide                                20
  1364.  
  1365.  
  1366.           /UE - Export Score File
  1367.           -----------------------
  1368.  
  1369.           This command (QASA only) is used to export the contents of
  1370.           certain fields in the score file to a file whose format is
  1371.           acceptable to the vast majority of database and spreadsheet
  1372.           programs. This command is password-protected.
  1373.  
  1374.           By using this command, you may import all scores for an entire
  1375.           class into a spreadsheet, for example, and use the spreadsheet to
  1376.           calculate bell curves, normalize the scores or convert them to
  1377.           another form. You could average the scores for several QASA quiz
  1378.           sessions. You may also use a database program to maintain a
  1379.           history by student of all quizzes and their scores.
  1380.  
  1381.           This command will pop up a directory window so that you may enter
  1382.           the directory containing the score file to export, or you may
  1383.           accept the directory shown by pressing ENTER. Once you have
  1384.           selected the directory, a file-selection window will be displayed
  1385.           so that you may select the score file to export.
  1386.  
  1387.           Once you select a file, QASA will check if the score file is
  1388.           encrypted, and if so, will ask if you wish to decrypt it first.
  1389.           An encrypted score file may not be exported. If you answer NO,
  1390.           then the command is aborted.
  1391.  
  1392.           QASA will then locate and export certain fields in the score
  1393.           file, creating one line for each record in the score file, as
  1394.           follows:
  1395.  
  1396.                Student, Database, Score, Grade, Termination, Time
  1397.  
  1398.                where:
  1399.  
  1400.                     Student        is the student's name in quotes
  1401.                     Database       is the name of the database in quotes
  1402.                     Score          is the final score
  1403.                     Grade          is the letter grade in quotes
  1404.                     Termination    is the termination explanation in quotes
  1405.                     Time           is the elapsed time in seconds
  1406.  
  1407.  
  1408.  
  1409.  
  1410.  
  1411.  
  1412.  
  1413.  
  1414.  
  1415.  
  1416.  
  1417.  
  1418.           Copyright (C) 1988-1993 Harold J. Endresen, Quid Pro Quo Software
  1419.  
  1420.  
  1421.  
  1422.           Q&A Study Aid V4.1 User's Guide                                21
  1423.  
  1424.  
  1425.           Note that QASA will also export a header line, which you may
  1426.           delete from the spreadsheet or database if you wish. The follow-
  1427.           ing is an example of an exported score file containing two
  1428.           records.
  1429.  
  1430.  
  1431.           "Student", "Database", "Score", "Grade", "Termination", "Time"
  1432.           "John Public", "History Quiz", 79.23, "C+", "Time Out", 720
  1433.           "Jane Doe", "Math Quiz", 94.00, "A", "Completed", 298
  1434.  
  1435.           If you are exporting the score file for use with Lotus(r) 1-2-3,
  1436.           you would use the /FI (File/Import) command. Be sure to select
  1437.           the "Numbers" option.
  1438.  
  1439.  
  1440.           /UR - Print Registration Form
  1441.           -----------------------------
  1442.  
  1443.           This command (QASA only) will print a registration form to make
  1444.           as easy as possible for you to register your copy of Q&A Study
  1445.           Aid. You can also use CompuServe to register single copies.
  1446.  
  1447.           You may print the form to any device or any file. The device must
  1448.           be able to interpret carriage return, line feed, backspace, form
  1449.           feed, and normal text.
  1450.  
  1451.           The registration form will prompt your for the necessary informa-
  1452.           tion. In addition, it will determine a number of items concerning
  1453.           your system configuration. If any of the configuration items is
  1454.           incorrect, please make the necessary corrections. For example,
  1455.           QASA will not detect an LCD screen - only color or monochrome.
  1456.  
  1457.           This form will display the registration price schedule and
  1458.           calculate the registration fee based upon the number of copies
  1459.           you wish to register.
  1460.  
  1461.           If you have already registered your copy(ies) or Q&A Study Aid,
  1462.           this option will not appear on the menu.
  1463.  
  1464.  
  1465.           Scoring Window
  1466.           --------------
  1467.  
  1468.           The scoring window always shows the current state of both you and
  1469.           QASA/QA. The scoring window is blank until a database is loaded,
  1470.           so you may easily ascertain if a database is loaded or not. The
  1471.           items that may appear in the scoring window are described below.
  1472.  
  1473.                Time Left      This shows the time remaining to answer all
  1474.                               questions in a database that has a time lim-
  1475.  
  1476.  
  1477.           Copyright (C) 1988-1993 Harold J. Endresen, Quid Pro Quo Software
  1478.  
  1479.  
  1480.  
  1481.           Q&A Study Aid V4.1 User's Guide                                22
  1482.  
  1483.  
  1484.                               it. If the database does not have a time
  1485.                               limit, this field will not be displayed. If
  1486.                               the database has a time limit associated with
  1487.                               it, you will see this time counting down to
  1488.                               zero. At zero, it will change to 'Time Out'.
  1489.  
  1490.                Mode           This is the current question-indexing mode,
  1491.                               and will be "Random" or "Sequential". QASA
  1492.                               always starts up in sequential mode. The mode
  1493.                               may be specified in the database.
  1494.  
  1495.                Questions      This specifies the total number of questions
  1496.                               in the database.
  1497.  
  1498.                Answered       This indicates the number of questions that
  1499.                               you have answered. When it equals the number
  1500.                               of questions in the database, your final
  1501.                               score will be displayed.
  1502.  
  1503.                Correct        This is the number of questions that you have
  1504.                               answered correctly.
  1505.  
  1506.                Score          Your score is a simple ratio of the number of
  1507.                               possible points to the number you have been
  1508.                               awarded, and is displayed in percent.
  1509.  
  1510.                Grade          If optional letter-grade equivalencies have
  1511.                               been assigned in the database, and the grade
  1512.                               display has not been turned OFF, then this
  1513.                               will show the current grade that has been
  1514.                               achieved relative to the score. The database
  1515.                               may be configured so that the grade is not
  1516.                               displayed at all until a certain score has
  1517.                               been achieved; once this base score is
  1518.                               achieved, the grade will be updated along
  1519.                               with the score. If the grade display has been
  1520.                               turned off, or if there are no grade equiva-
  1521.                               lencies in the database, then this field will
  1522.                               not be shown.
  1523.  
  1524.  
  1525.           Answering Questions
  1526.           -------------------
  1527.  
  1528.           QASA/QA do not require you to answer questions in the order they
  1529.           are presented (as defined by the mode). QASA/QA will determine
  1530.           the next question using the mode you select (or the mode that
  1531.           been forced in the database), but once the question is displayed,
  1532.           you may elect to skip it (intending to come back to it later) and
  1533.           let QASA/QA present the next one. QASA/QA will remember that the
  1534.  
  1535.  
  1536.           Copyright (C) 1988-1993 Harold J. Endresen, Quid Pro Quo Software
  1537.  
  1538.  
  1539.  
  1540.           Q&A Study Aid V4.1 User's Guide                                23
  1541.  
  1542.  
  1543.           question was skipped and display it again at some later time,
  1544.           depending upon the mode you have selected.
  1545.  
  1546.           Skipping a question is done simply by pressing the ESCape key
  1547.           when QASA/QA prompts for an answer. The question will not be
  1548.           scored, but QASA/QA will present it again after you have answered
  1549.           all of the remaining questions (sequential mode) or at any time
  1550.           (random mode). You may not omit a question, but you may essen-
  1551.           tially scan through the questions and answer them in the order
  1552.           you choose.
  1553.  
  1554.           If you choose to answer a question, you must enter a response.
  1555.           QASA/QA will not accept a blank answer.
  1556.  
  1557.           QASA/QA will always display the number of percentage points you
  1558.           will be awarded, if you answer correctly, at the right of the
  1559.           answer window. The number of points displayed is the ratio of the
  1560.           total weight of all questions in the database (or of all ques-
  1561.           tions in a subset of the database) to the weight of the question
  1562.           in points relative to 100%, as defined in the compiled database.
  1563.           If you answer incorrectly, you are awarded zero points.
  1564.  
  1565.           You may also enter a command any time you are being prompted for
  1566.           an answer.
  1567.  
  1568.  
  1569.  
  1570.  
  1571.  
  1572.  
  1573.  
  1574.  
  1575.  
  1576.  
  1577.  
  1578.  
  1579.  
  1580.  
  1581.  
  1582.  
  1583.  
  1584.  
  1585.  
  1586.  
  1587.  
  1588.  
  1589.  
  1590.  
  1591.  
  1592.  
  1593.  
  1594.  
  1595.           Copyright (C) 1988-1993 Harold J. Endresen, Quid Pro Quo Software
  1596.  
  1597.  
  1598.  
  1599.           Q&A Study Aid V4.1 User's Guide                                24
  1600.  
  1601.  
  1602.           Creating a Database
  1603.           -------------------
  1604.  
  1605.           The database is the heart of QASA. QASA receives virtually all of
  1606.           the information it needs to present and score your answers from
  1607.           the database.
  1608.  
  1609.           The database is created from a plain ASCII, or 'flat' file, and
  1610.           then compiled using the database compiler within QASA. The input
  1611.           given to QASA is called the database definition file; the output
  1612.           of QASA is the compiled database. QASA creates and destroys one
  1613.           intermediate file (with an extension of ".$$$") as it compiles
  1614.           the database definition file. QASA will require free disk space
  1615.           approximately equal to twice the size of the database definition
  1616.           file.
  1617.  
  1618.           QASA supports a large number of options that may be used to
  1619.           control the quiz session. Each option is specified using a
  1620.           command keyword followed by zero or more lines of text. It is
  1621.           important to remember that keywords must be on a line by them-
  1622.           selves with NO OTHER TEXT.
  1623.  
  1624.           If you use a word processor program to create the database
  1625.           definition file, be sure to use its 'non-document' mode to insure
  1626.           that it won't put in any formatting codes. A plain ASCII text
  1627.           editor is recommended (EDLIN, or preferably EDIT, which are
  1628.           included with DOS, are two such editors).
  1629.  
  1630.           To enable QASA to handle all of the common question formats
  1631.           except 'essay' questions, a very general database arrangement is
  1632.           used. QASA expects each question to be followed by the correct
  1633.           answer, which it uses to check the answer typed in by the user.
  1634.  
  1635.           QASA can handle multiple-choice, true/false, and fill-in-the-
  1636.           blank questions with equal ease.
  1637.  
  1638.           The database must contain one instance of each of two keywords
  1639.           for each question in the database. These keywords are, exactly,
  1640.           in quotes:
  1641.  
  1642.                "Q="
  1643.                "A="
  1644.  
  1645.           As you might expect, these stand for "question" and "answer". The
  1646.           question MUST precede the answer. QASA will complain about any
  1647.           irregularities it finds in the database when it constructs the
  1648.           compiled database file.
  1649.  
  1650.           The following is a simple example of a question and answer as
  1651.           they might appear in the database definition file. It is a
  1652.  
  1653.  
  1654.           Copyright (C) 1988-1993 Harold J. Endresen, Quid Pro Quo Software
  1655.  
  1656.  
  1657.  
  1658.           Q&A Study Aid V4.1 User's Guide                                25
  1659.  
  1660.  
  1661.           multiple-choice question. The following text is entered into the
  1662.           database definition file:
  1663.  
  1664.           Q=
  1665.           Multiple-choice:
  1666.  
  1667.           What is the capital of Pennsylvania?
  1668.           A. Philadelphia
  1669.           B. Washington, D.C.
  1670.           C. Harrisburg
  1671.           D. None of the above
  1672.  
  1673.           A=
  1674.           C
  1675.  
  1676.           QASA/QA will display the question beginning on the line immedi-
  1677.           ately following the 'Q=' line. The end of the question is marked
  1678.           by the 'A='. All lines between these markers form the question,
  1679.           which QASA will display exactly as it appears in the database.
  1680.           You may, therefore, format your questions any way that you wish.
  1681.           QASA does absolutely no interpretation of the text you enter for
  1682.           a question. QASA will impose NO restrictions other than the
  1683.           number of rows and columns; you may use up to 15 lines of 76
  1684.           characters. If the question contains more than 15 lines, the
  1685.           extra lines will be discarded and you will receive an error
  1686.           message. Blank lines between the end of the actual question and
  1687.           the 'A=' line are effectively discarded and do not count against
  1688.           the 15 lines allowed. The question above, therefore, consists of
  1689.           seven lines, not eight.
  1690.  
  1691.           Note that the 'Multiple-choice' prompt is actually a part of the
  1692.           database - NOT hard-coded into QASA. You may include this as part
  1693.           of your database or omit it if you wish. Similarly, you may
  1694.           number your questions any way you wish, or not at all. QASA/QA,
  1695.           however, will consider them to be numbered sequentially beginning
  1696.           with one as the first question in the database when it creates a
  1697.           score file entry.
  1698.  
  1699.           The answer follows beginning on the line immediately after the
  1700.           'A='. In this example, it is 'C'. All this means is that QASA
  1701.           will score as correct any response to the question that is
  1702.           exactly 'C' OR 'c' - case is not significant. QASA/QA does some
  1703.           preformatting of these strings prior to the comparison, however.
  1704.           Both the answer in the database and the answer typed in when the
  1705.           database is executed are processed the same way:
  1706.  
  1707.  
  1708.  
  1709.  
  1710.  
  1711.  
  1712.  
  1713.           Copyright (C) 1988-1993 Harold J. Endresen, Quid Pro Quo Software
  1714.  
  1715.  
  1716.  
  1717.           Q&A Study Aid V4.1 User's Guide                                26
  1718.  
  1719.  
  1720.                1.   All leading whitespace is removed. This means that
  1721.                          C
  1722.                     and
  1723.                                    C
  1724.                     are equivalent and are themselves equivalent to the 'C'
  1725.                     in the example above.
  1726.  
  1727.                2.   All leading and trailing whitespace, including newline
  1728.                     characters, is removed.
  1729.  
  1730.                3.   All whitespace (blanks and tabs) between words is col-
  1731.                     lapsed to a single space:
  1732.                          "Washington, D.C."
  1733.                     and
  1734.                          "Washington,        D.C."
  1735.                     are equivalent.
  1736.  
  1737.                4.   All characters are folded to uppercase; 'Yes' and 'yes'
  1738.                     are therefore equivalent.
  1739.  
  1740.           These steps insure that a response will not be scored as incor-
  1741.           rect due to the position or character case of any part of the
  1742.           response in either your answer or that in the database.
  1743.  
  1744.           Note that these same rules are also applied to the 'Q=' and 'A='
  1745.           markers. They may, therefore, appear anywhere on the line. You
  1746.           cannot, however, insert anything between 'Q' and '=', nor can you
  1747.           put anything else on the line with the command keyword.
  1748.  
  1749.           In the example above, one correct answer was specified. The only
  1750.           answer that could be scored as correct is 'C' (and 'c', of
  1751.           course). Note that we could just as well have used numbers as
  1752.           selectors and given '3' as the answer. QASA makes no attempt to
  1753.           interpret this information; it simply looks for an exact match
  1754.           based on the criteria outlined above.
  1755.  
  1756.           This next example will demonstrate a true/false question.
  1757.  
  1758.           Q=
  1759.  
  1760.  
  1761.  
  1762.                     Answer true or false:
  1763.  
  1764.                     QASA understands the information in the database.
  1765.                          A=
  1766.           False
  1767.  
  1768.           Note the (valid) position of the 'A='. This time we have indented
  1769.           the question using tabs. When QASA compiles the question, it
  1770.  
  1771.  
  1772.           Copyright (C) 1988-1993 Harold J. Endresen, Quid Pro Quo Software
  1773.  
  1774.  
  1775.  
  1776.           Q&A Study Aid V4.1 User's Guide                                27
  1777.  
  1778.  
  1779.           expands the tabs automatically (using 8-column tab stops) to
  1780.           maintain the alignment as it is in the database definition file.
  1781.           We also have three blank lines after the 'Q='; this serves to
  1782.           shift the question down toward the center of the question window
  1783.           to make it look nicer.
  1784.  
  1785.           This example is not good practice (although it will be compiled
  1786.           correctly), since the 'A=' would be easy to miss if the database
  1787.           were edited, and the indentation is inconsistent. It does,
  1788.           however, have a more serious drawback: to get the question right,
  1789.           you must type in 'false' - all 5 characters - and 'false' is one
  1790.           word I just cannot type (it always comes out 'flase')!
  1791.  
  1792.           For a true/false question, one would be likely to respond with
  1793.           'T', 'F', 'yes', 'y', 'no', 'n', or possibly '1' and '0'. To
  1794.           accommodate these options, QASA allows more than one correct
  1795.           answer. In fact, every nonblank line following 'A=' is treated as
  1796.           a correct answer. The second example above, then, would be more
  1797.           appropriately given by
  1798.  
  1799.           Q=
  1800.  
  1801.  
  1802.  
  1803.                     Answer true or false:
  1804.  
  1805.                     QASA understands the information in the database.
  1806.  
  1807.           A=
  1808.           False
  1809.           F
  1810.           No
  1811.           N
  1812.           0
  1813.  
  1814.           This permits any of the five answers to be regarded as correct.
  1815.  
  1816.           If you give an incorrect response to a question (e.g., one that
  1817.           is not among the list of correct answers), QASA will display the
  1818.           correct answer for you, as well as omit one or more points from
  1819.           your score. When QASA/QA displays the correct answer, it uses the
  1820.           first one given in the answer list. What this means is that
  1821.           QASA/QA will display
  1822.  
  1823.                            Incorrect. The correct answer is
  1824.                                         False
  1825.                               Press any key to continue.
  1826.  
  1827.           which is more professional than 'N', for example.
  1828.  
  1829.  
  1830.  
  1831.           Copyright (C) 1988-1993 Harold J. Endresen, Quid Pro Quo Software
  1832.  
  1833.  
  1834.  
  1835.           Q&A Study Aid V4.1 User's Guide                                28
  1836.  
  1837.  
  1838.           This feature adds a lot of versatility to QASA and QA. Since
  1839.           QASA/QA is intended to be a study aid as well as a general-
  1840.           purpose testing program, it provides reinforcement of incorrect
  1841.           answers by permitting a more complete correct answer. To demon-
  1842.           strate this, we'll use a third example; this time, a fill-in-the-
  1843.           blank question:
  1844.  
  1845.           Q=
  1846.                The speed of light is ______ km/sec.
  1847.  
  1848.           A=
  1849.                Light travels at 300,000 km/sec.
  1850.                300000
  1851.                300,000
  1852.                300K
  1853.  
  1854.           In this example, an incorrect response will elicit
  1855.  
  1856.                            Incorrect. The correct answer is
  1857.                            Light travels at 300,000 km/sec.
  1858.                               Press any key to continue.
  1859.  
  1860.           Of course, this is also a correct answer in itself, but not a
  1861.           likely one. If you do enter it, it will be scored as correct. You
  1862.           would, however, be required to include the comma, the slash
  1863.           between 'km' and 'sec', and the period.
  1864.  
  1865.           There are three more plausible correct answers that QASA would
  1866.           consider to be correct. Any one of them is sufficient to credit
  1867.           the answer as correct.
  1868.  
  1869.           Note that the display of the correct answer may be disabled
  1870.           beginning with Version 3.0 of QASA. This is done by issuing the
  1871.           'D=' (Display Off) command in the database. This a global command
  1872.           and will turn off the display of all answers, no matter where you
  1873.           place the command in the database definition file.
  1874.  
  1875.  
  1876.           Macros
  1877.           ------
  1878.  
  1879.           When creating a large database definition file, it is annoying to
  1880.           have to type the four or more common answers to a true/false
  1881.           question. To make this easier, QASA supports simple macros. A
  1882.           macro is a block of text that is inserted in place of a macro
  1883.           identifier. We may therefore create a macro for 'true' and a
  1884.           macro for 'false', and use the macro identifier instead of typing
  1885.           all four answer lines. These macros would look something like the
  1886.           following example.
  1887.  
  1888.  
  1889.  
  1890.           Copyright (C) 1988-1993 Harold J. Endresen, Quid Pro Quo Software
  1891.  
  1892.  
  1893.  
  1894.           Q&A Study Aid V4.1 User's Guide                                29
  1895.  
  1896.  
  1897.           M=
  1898.                $TRUE$
  1899.                true
  1900.                t
  1901.                yes
  1902.                y
  1903.  
  1904.           M=
  1905.                $FALSE$
  1906.                false
  1907.                f
  1908.                no
  1909.                n
  1910.  
  1911.  
  1912.           Q=
  1913.  
  1914.                     Answer true or false:
  1915.  
  1916.                     QASA understands the information in the database.
  1917.  
  1918.           A=
  1919.           $FALSE$
  1920.  
  1921.           The "M=" is the macro keyword, and tells QASA that the following
  1922.           lines form a macro definition. The first line following the macro
  1923.           keyword is the macro identifier. You may use ANY character string
  1924.           as a macro identifier, provided it does not contain blanks or
  1925.           tabs. The dollar signs are not necessary, but serve nicely to
  1926.           identify $FALSE$ as a macro invocation. When QASA reads the
  1927.           identifier, it will substitute all lines following the macro
  1928.           identifier up to the first blank line or keyword, whichever is
  1929.           found first. Note that QASA will display "false" as the correct
  1930.           answer if the question is answered incorrectly, as it is the
  1931.           first answer in the answer list formed by expanding the macro.
  1932.  
  1933.           The above is a short introduction to creating a database defini-
  1934.           tion file. The following section describes the QASA compiler in
  1935.           detail.
  1936.  
  1937.  
  1938.           The QASA Database Compiler
  1939.           ---------------------------
  1940.  
  1941.           The QASA compiler is used only when a database is first created.
  1942.           A password (if entered using the /UP command) is required to gain
  1943.           access to it. Once the database definition file has been created,
  1944.           it is compiled with QASA, and the compiled database file (which
  1945.           has an extension of .QA) is used with the QASA program. This
  1946.           offers several advantages, among them:
  1947.  
  1948.  
  1949.           Copyright (C) 1988-1993 Harold J. Endresen, Quid Pro Quo Software
  1950.  
  1951.  
  1952.  
  1953.           Q&A Study Aid V4.1 User's Guide                                30
  1954.  
  1955.  
  1956.                1.   The database is encrypted. A user of QASA or QA cannot
  1957.                     look in the file using any viewing, listing, or debug-
  1958.                     ging program and see the questions and answers. The
  1959.                     QASA/QA interpreter knows the encryption method and
  1960.                     decrypts the database as it reads it.
  1961.  
  1962.                2.   The author of the database definition file may specify
  1963.                     a number of options to control the quiz session. These
  1964.                     options cannot be seen or modified by anyone using QASA
  1965.                     or QA.
  1966.  
  1967.                3.   Since the database has been preprocessed by QASA,
  1968.                     loading and display of questions is fast and error-
  1969.                     free. It is not necessary for QASA or QA to perform any
  1970.                     formatting at run time.
  1971.  
  1972.  
  1973.           Using The QASA Compiler
  1974.           ------------------------
  1975.  
  1976.           When you issue the /UC command, QASA will prompt for a password
  1977.           (if one has been defined), and will then display a window showing
  1978.           the current directory. If your database definition files are in
  1979.           another directory, you may edit the directory here using the
  1980.           standard DOS directory naming conventions. Once you accept the
  1981.           directory by pressing ENTER, a file-selection window will be
  1982.           displayed, listing all of the database definition files in that
  1983.           directory (e.g., all files with an extension of ".DEF"). QASA
  1984.           requires you to use an extension of ".DEF" for the database
  1985.           definition file. Select the file you wish to compile and press
  1986.           ENTER. QASA will compile the database and then present a screen
  1987.           showing the results of the compilation.
  1988.  
  1989.           QASA will not make any changes to the database definition file
  1990.           (your 'source' file). It will create a compiled database file of
  1991.           the same base name, but with an extension of .QA. If the database
  1992.           definition file is named QUIZ.DEF, then the compiled database
  1993.           will have a name of QUIZ.QA. If the compiled database file
  1994.           already exists, it is overwritten by QASA, and the original
  1995.           contents will be lost. QASA will NOT warn you of this.
  1996.  
  1997.           When QASA is finished, it will display the results of the compi-
  1998.           lation, including the options you selected in the definition
  1999.           file. The output below was produced by compiling the sample
  2000.           database SAMPLE.DEF (the screen window has been reduced horizon-
  2001.           tally to fit on the page).
  2002.  
  2003.  
  2004.  
  2005.  
  2006.  
  2007.  
  2008.           Copyright (C) 1988-1993 Harold J. Endresen, Quid Pro Quo Software
  2009.  
  2010.  
  2011.  
  2012.           Q&A Study Aid V4.1 User's Guide                                31
  2013.  
  2014.  
  2015.           +--------------------- Compilation Results ---------------------+
  2016.           | Database Name:  Q&A Study Aid Sample Database                 |
  2017.           | Input File:     C:\QPQ\V41\SAMPLE.DEF                         |
  2018.           | Output File:    C:\QPQ\V41\SAMPLE.QA                          |
  2019.           | Score Filename: SAMPLE.SCR          Total Weight:    35       |
  2020.           | Time Limit:     00:10:00            Mode Lock:       (none)   |
  2021.           | Clear Command:  Enabled             Answer Display:  Enabled  |
  2022.           | Source Lines:   496                 Total Questions: 20 of 25 |
  2023.           | Macro List:                         Letter Grades:   13       |
  2024.           | $TRUE$                                                        |
  2025.           | $FALSE$                                                       |
  2026.           |                                                               |
  2027.           |                                                               |
  2028.           |                                                               |
  2029.           |                                                               |
  2030.           |                                                               |
  2031.           |                    Press Any Key To Continue                  |
  2032.           +---------------------------------------------------------------+
  2033.  
  2034.  
  2035.           QASA Language Syntax
  2036.           ---------------------
  2037.  
  2038.           QASA, being a true compiler, requires that you follow certain
  2039.           syntactical rules when creating a database definition file. The
  2040.           syntax was made as simple and forgiving as possible to minimize
  2041.           the learning time.
  2042.  
  2043.           The QASA language is line-oriented, meaning that QASA views its
  2044.           input in terms of whole lines. You may not, therefore, put two
  2045.           keyword markers on the same line, for example.
  2046.  
  2047.           The following is a short summary of the keywords that QASA uses.
  2048.  
  2049.                Q=   Question text
  2050.                A=   Answer list
  2051.                P=   remove Punctuation from the next answer
  2052.                N=   quiz Name
  2053.                M=   Macro definition
  2054.                T=   Time limit
  2055.                C=   Clear not allowed
  2056.                S=   lock in Sequential mode
  2057.                R=   lock in Random mode
  2058.                F=   output score Filename
  2059.                E=   Encrypt score file
  2060.                W=   assign Weighting
  2061.                G=   assign letter-Grade equivalencies
  2062.                D=   disable Display of incorrect answers
  2063.                L=   Limit the number of questions to a subset
  2064.                O=   omit the subset at compile time as opposed to run time
  2065.  
  2066.  
  2067.           Copyright (C) 1988-1993 Harold J. Endresen, Quid Pro Quo Software
  2068.  
  2069.  
  2070.  
  2071.           Q&A Study Aid V4.1 User's Guide                                32
  2072.  
  2073.  
  2074.           Each of these keywords is described in the following paragraphs.
  2075.  
  2076.           QASA scans and discards all text in the database definition file
  2077.           that is not part of a keyword interpretation. This means that you
  2078.           may insert comments almost anywhere, without using special
  2079.           comment delimiters or markers. Since QASA is line-oriented, you
  2080.           may not, of course, place a comment on the same line with any
  2081.           keyword or its associated text. Comments are otherwise unre-
  2082.           stricted. The sample database definition file SAMPLE.DEF provides
  2083.           many examples of the use of comments.
  2084.  
  2085.           Terminators
  2086.           -----------
  2087.  
  2088.           Every QASA command keyword (e.g., "Q=", "A=", etc.) has a termi-
  2089.           nation, which tells the compiler when the end of the keyword
  2090.           interpretation has been reached. For all QASA keywords, with the
  2091.           single exception of the Q= keyword, the termination is the same:
  2092.           a blank line, another keyword, or end-of-file. In this context, a
  2093.           blank line is any line that contains zero or more space or tab
  2094.           characters only. For the Q= keyword, a blank line is NOT a termi-
  2095.           nation; only the 'A=' keyword terminates a question. This is to
  2096.           allow blank lines in the question text. You must be careful not
  2097.           to place comment lines between the Q= and A= keywords, since
  2098.           these will be regarded as part of the question and displayed on
  2099.           the QASA or QA screen.
  2100.  
  2101.  
  2102.           The Q= and A= Keywords
  2103.           ----------------------
  2104.  
  2105.           As mentioned previously, Q= and A= are the keywords for 'ques-
  2106.           tion' and 'answer', respectively. The syntax is as follows:
  2107.  
  2108.                Q=
  2109.                <question text>
  2110.                <question text>
  2111.                <blank line(s)>
  2112.                ....
  2113.                <question text>
  2114.                <blank line(s)>
  2115.                A=
  2116.                <displayed answer>
  2117.                ....
  2118.                <termination>
  2119.  
  2120.           A question may not have more than 15 lines of text associated
  2121.           with it, and you are limited to 76 characters per line. Within
  2122.           this rectangular boundary, you are unrestricted. If you exceed
  2123.           the allowed number of lines or if a line contains more than 76
  2124.  
  2125.  
  2126.           Copyright (C) 1988-1993 Harold J. Endresen, Quid Pro Quo Software
  2127.  
  2128.  
  2129.  
  2130.           Q&A Study Aid V4.1 User's Guide                                33
  2131.  
  2132.  
  2133.           characters (after tab and macro expansion), QASA will display an
  2134.           error message.
  2135.  
  2136.           You are permitted any number of answer lines, limited only by the
  2137.           amount of memory available in the PC running QASA or QA. If the
  2138.           PC has 128K bytes or more of available memory (free memory above
  2139.           DOS and all TSRs), you are essentially unrestricted.
  2140.  
  2141.  
  2142.           The P= Keyword
  2143.           --------------
  2144.  
  2145.           This keyword is used to simplify the answer list for answers that
  2146.           contain unimportant punctuation. For example, if the correct
  2147.           answer to a question is "Washington, D.C.", you would not want a
  2148.           student scored as incorrect if he or she were to answer with
  2149.           "Washington DC". The P= keyword prevents this situation.
  2150.  
  2151.           The P= keyword applies ONLY to the next answer list following the
  2152.           keyword. Once the next answer is compiled, punctuation is once
  2153.           again significant.
  2154.  
  2155.           Also, the P= keyword causes punctuation to be stripped from all
  2156.           answer lines beginning with the SECOND answer line. This is so
  2157.           that the correct answer can be displayed with all punctuation
  2158.           intact if the question is answered incorrectly. To elaborate on
  2159.           the "Washington, D.C." example, you could use:
  2160.  
  2161.           P=
  2162.           Q=
  2163.           What is the capitol of the United States?
  2164.           A=
  2165.           Washington, D.C.
  2166.           Washington, D.C.
  2167.  
  2168.           Note that the FIRST answer line will be left intact, but all
  2169.           punctuation will be removed from the second line when it is
  2170.           compiled. Also, when the user enters an answer in response to the
  2171.           question, all punctuation will be removed from the answer before
  2172.           it is compared to the answer list. Therefore, any answer that
  2173.           contains "Washington DC" will be scored as correct: "Washington,
  2174.           DC", "Washington D.C.", and so on. It is NOT necessary to include
  2175.           the punctuation in the second answer line above.
  2176.  
  2177.           This keyword is also useful for numbers; e.g., it removes any
  2178.           distinction between "1,000" and "1000", and between "$50" and
  2179.           "50". In some cases you will have to exercise caution, as in
  2180.           "$50.00", where "5000" would be scored as correct, even though it
  2181.           is not at all what was intended.
  2182.  
  2183.  
  2184.  
  2185.           Copyright (C) 1988-1993 Harold J. Endresen, Quid Pro Quo Software
  2186.  
  2187.  
  2188.  
  2189.           Q&A Study Aid V4.1 User's Guide                                34
  2190.  
  2191.  
  2192.           The N= Keyword
  2193.           --------------
  2194.  
  2195.           The N= keyword is used to specify the quiz name. The name must
  2196.           appear on the line following the keyword, and may be up to 60
  2197.           characters in length. When the database is loaded into QASA or
  2198.           QA, this name appears in the top border of the center (question)
  2199.           window.
  2200.  
  2201.           For example, to name a quiz on American history as such, you
  2202.           would use
  2203.  
  2204.           N=
  2205.           American History Quiz
  2206.  
  2207.  
  2208.           The M= Keyword
  2209.           --------------
  2210.  
  2211.           The M= keyword is the macro definition keyword, and indicates to
  2212.           QASA that the following lines are a macro definition. The macro
  2213.           definition takes the following form:
  2214.  
  2215.                M=
  2216.                <macro identifier>
  2217.                <first macro line>
  2218.                <second macro line>
  2219.                ..............
  2220.                <Nth macro line>
  2221.                <termination>
  2222.  
  2223.           Macros are expanded only within question and answer text, so you
  2224.           may not use a macro to specify a score file name, for example.
  2225.  
  2226.           To build a macro for 'TRUE' from two other macros, you could use:
  2227.  
  2228.           M=
  2229.           $T$
  2230.           True
  2231.           T
  2232.           M=
  2233.           $Y$
  2234.           Yes
  2235.           Y
  2236.           M=
  2237.           $TRUE$
  2238.           $T$
  2239.           $Y$
  2240.  
  2241.  
  2242.  
  2243.  
  2244.           Copyright (C) 1988-1993 Harold J. Endresen, Quid Pro Quo Software
  2245.  
  2246.  
  2247.  
  2248.           Q&A Study Aid V4.1 User's Guide                                35
  2249.  
  2250.  
  2251.           We have defined three macros, "$T$", "$Y$", and "$TRUE$". If QASA
  2252.           encounters $TRUE$ in a question or answer, it will replace it
  2253.           with:
  2254.  
  2255.           True
  2256.           T
  2257.           Yes
  2258.           Y
  2259.  
  2260.           because "True" and "T" are expansions of $T$ and "Yes" and "Y"
  2261.           are expansions of $Y$. Note that blank lines are unnecessary
  2262.           between the macro definitions, since each is terminated by the M=
  2263.           keyword of the following macro.
  2264.  
  2265.           Macro invocations MUST be surrounded by whitespace. For example,
  2266.           many multiple-choice questions use the blanket selectors "none of
  2267.           the above" and "all of the above". You could therefore use the
  2268.           following macros:
  2269.  
  2270.           M=
  2271.           $NONE$
  2272.           None of the above.
  2273.           M=
  2274.           $ALL$
  2275.           All of the above.
  2276.  
  2277.           and write a multiple-choice question as:
  2278.  
  2279.           Q=
  2280.           Multiple-choice:
  2281.  
  2282.           In what year did Christopher Columbus land in the New World?
  2283.  
  2284.                1. 1592
  2285.                2. 1492
  2286.                3. 1066
  2287.                4. $NONE$
  2288.                5. $ALL$
  2289.  
  2290.           A=
  2291.           2. 1492
  2292.           2
  2293.           1492
  2294.  
  2295.  
  2296.  
  2297.  
  2298.  
  2299.  
  2300.  
  2301.  
  2302.  
  2303.           Copyright (C) 1988-1993 Harold J. Endresen, Quid Pro Quo Software
  2304.  
  2305.  
  2306.  
  2307.           Q&A Study Aid V4.1 User's Guide                                36
  2308.  
  2309.  
  2310.           QASA will expand this to:
  2311.  
  2312.           Q=
  2313.           Multiple-choice:
  2314.  
  2315.           In what year did Christopher Columbus land in the New World?
  2316.  
  2317.                1. 1592
  2318.                2. 1492
  2319.                3. 1066
  2320.                4. None of the above.
  2321.                5. All of the above.
  2322.  
  2323.           A=
  2324.           2. 1492
  2325.           2
  2326.           1492
  2327.  
  2328.           Remember that the QASA compiler is line-oriented, however. If you
  2329.           put the following in the database definition file:
  2330.  
  2331.           M=
  2332.           $NW$
  2333.           New World
  2334.  
  2335.           Q=
  2336.           Multiple-choice:
  2337.  
  2338.           In what year did Christopher Columbus land in the $NW$?
  2339.  
  2340.                1. 1592
  2341.                2. 1492
  2342.                3. 1066
  2343.                4. None of the above.
  2344.                5. All of the above.
  2345.  
  2346.           QASA will NOT expand it because there is no whitespace between
  2347.           $NW$ and the '?'. If, however, you use
  2348.  
  2349.  
  2350.  
  2351.  
  2352.  
  2353.  
  2354.  
  2355.  
  2356.  
  2357.  
  2358.  
  2359.  
  2360.  
  2361.  
  2362.           Copyright (C) 1988-1993 Harold J. Endresen, Quid Pro Quo Software
  2363.  
  2364.  
  2365.  
  2366.           Q&A Study Aid V4.1 User's Guide                                37
  2367.  
  2368.  
  2369.           M=
  2370.           $NW$
  2371.           New World
  2372.  
  2373.           Q=
  2374.           Multiple-choice:
  2375.  
  2376.           In what year did Christopher Columbus land in the $NW$ ?
  2377.  
  2378.                1. 1592
  2379.                2. 1492
  2380.                3. 1066
  2381.                4. None of the above.
  2382.                5. All of the above.
  2383.  
  2384.           QASA will expand it to
  2385.  
  2386.           Q=
  2387.           Multiple-choice:
  2388.  
  2389.           In what year did Christopher Columbus land in the New World
  2390.            ?
  2391.                1. 1592
  2392.                2. 1492
  2393.                3. 1066
  2394.                4. None of the above.
  2395.                5. All of the above.
  2396.  
  2397.           because the macro expansion includes the newline. You should not,
  2398.           therefore, attempt to use a macro in the middle of a block of
  2399.           text.
  2400.  
  2401.           Although QASA contains a two-pass compiler, macros must be
  2402.           defined before they can be used. If you place a macro definition
  2403.           in the middle of the database definition file and use the macro
  2404.           identifier before and after it, then the identifiers that appear
  2405.           before the macro definition will NOT be expanded. Define all of
  2406.           your macros before entering the first question.
  2407.  
  2408.           As shown in the examples above, macros are expanded recursively,
  2409.           so if you place the macro identifier in any of the macro defini-
  2410.           tion lines, you will create a self-referential macro. QASA will
  2411.           detect this condition no matter how deeply nested the reference
  2412.           may be. A self-referential macro will cause a fatal compiler
  2413.           error. Recursive macros are allowed so that you may build complex
  2414.           macros from simple ones if you wish. An obvious self-referential
  2415.           macro is shown below:
  2416.  
  2417.  
  2418.  
  2419.  
  2420.  
  2421.           Copyright (C) 1988-1993 Harold J. Endresen, Quid Pro Quo Software
  2422.  
  2423.  
  2424.  
  2425.           Q&A Study Aid V4.1 User's Guide                                38
  2426.  
  2427.  
  2428.           M=
  2429.           $MACRONAME$
  2430.           macro text line 1
  2431.           macro text line 2
  2432.           $MACRONAME$
  2433.  
  2434.           When QASA encounters the second "$MACRONAME$", it would attempt
  2435.           to expand it using the current definition of $MACRONAME$, which
  2436.           would in turn cause it to encounter $MACRONAME$ again, and so on,
  2437.           until the program runs out of memory. QASA will detect this
  2438.           condition and generate an error message.
  2439.  
  2440.           Not all self-referential macros are obvious, however. Note that
  2441.           you can create a self-referential macro using two macros, as
  2442.           shown below:
  2443.  
  2444.           M=
  2445.           $MACRO 1$
  2446.           text
  2447.           text
  2448.           $MACRO 2$
  2449.  
  2450.           M=
  2451.           $MACRO 2$
  2452.           text
  2453.           text
  2454.           $MACRO 1$
  2455.  
  2456.           In this case, both macros refer to the other when expanded,
  2457.           creating a circular reference. This will also cause a fatal
  2458.           compiler error.
  2459.  
  2460.  
  2461.           The T= Keyword
  2462.           --------------
  2463.  
  2464.           This is the time limit keyword. Include it in the database
  2465.           definition file to specify a time limit. If you omit it, there is
  2466.           no time limit.
  2467.  
  2468.           The syntax is as follows:
  2469.  
  2470.                T=
  2471.                HH:MM:SS
  2472.  
  2473.           where HH is hours, MM is minutes, and SS is seconds. If the time
  2474.           limit is less than an hour, you may omit the hours field; simi-
  2475.           larly, if the time limit is less than a minute, you may omit the
  2476.           hours and minutes fields. The sample database definition file
  2477.           contains a 10-minute timeout, given by
  2478.  
  2479.  
  2480.           Copyright (C) 1988-1993 Harold J. Endresen, Quid Pro Quo Software
  2481.  
  2482.  
  2483.  
  2484.           Q&A Study Aid V4.1 User's Guide                                39
  2485.  
  2486.  
  2487.           T=
  2488.           10:00
  2489.  
  2490.           Note:     If you specify a time limit for a database, the /FS
  2491.                     (File/Save Database) command will be disabled. A user
  2492.                     attempting to use this command will receive an error
  2493.                     message, and the command will be ignored.
  2494.  
  2495.  
  2496.           The C= Keyword
  2497.           --------------
  2498.  
  2499.           This keyword is used to disable the Clear command. An individual
  2500.           taking a quiz with QASA can use the Clear command to reset the
  2501.           score and essentially do the quiz twice. The author of the
  2502.           database definition file may prevent this by entering
  2503.  
  2504.           C=
  2505.  
  2506.           in the database definition file. When this is done, QASA will
  2507.           ignore the Clear command completely.
  2508.  
  2509.           Note that if the Clear command is allowed, by omission of the C=
  2510.           keyword, and the score file is enabled with the F= keyword
  2511.           (described later), then a score record will be written to the
  2512.           score file indicating that the user cleared the score and re-
  2513.           started the quiz.
  2514.  
  2515.  
  2516.           The S= and R= Keywords
  2517.           ----------------------
  2518.  
  2519.           These are the mode lock keywords, where S= stands for "sequen-
  2520.           tial" and R= stands for "random". These keywords are mutually
  2521.           exclusive; a database definition may not contain both keywords.
  2522.           If it does, an error will be generated by QASA.
  2523.  
  2524.           These keywords are used to lock QASA and QA in the mode specified
  2525.           by the keyword. If you do not give either keyword, then the user
  2526.           of QASA (only) is free to use the Mode command to change modes.
  2527.  
  2528.           For example, to lock QASA in sequential mode, use the following:
  2529.  
  2530.           S=
  2531.  
  2532.           and to lock QASA in random mode:
  2533.  
  2534.           R=
  2535.  
  2536.  
  2537.  
  2538.  
  2539.           Copyright (C) 1988-1993 Harold J. Endresen, Quid Pro Quo Software
  2540.  
  2541.  
  2542.  
  2543.           Q&A Study Aid V4.1 User's Guide                                40
  2544.  
  2545.  
  2546.           There are no other arguments. The lock remains in effect until
  2547.           another database is loaded (which may also be locked).
  2548.  
  2549.  
  2550.           The F= Keyword
  2551.           --------------
  2552.  
  2553.           The F= keyword controls logging of score information to a disk
  2554.           file. Logging is enabled by specifying a filename with the F=
  2555.           keyword, and disabled if you omit the keyword.
  2556.  
  2557.           The filename you specify may be any valid DOS pathname, up to 64
  2558.           characters in length. All scoring records are appended to the
  2559.           file if it already exists, or the file will be created automati-
  2560.           cally if it does not exist. QASA and QA will, however, force the
  2561.           filename to have an extension of ".SCR".
  2562.  
  2563.           The score logging file may exist on a file server of a networked
  2564.           system if desired. However, QASA AND QA DO NOT SUPPORT FILE
  2565.           SHARING. Typically, a networked system will require that a file
  2566.           be locked while it is being updated so that no other network user
  2567.           may access the file until the updating has been completed. If
  2568.           QASA or QA are used in a networked system, the networking exten-
  2569.           sions to DOS must provide this function.
  2570.  
  2571.           If networking is to be used, but the network does not perform
  2572.           locking on a file level, then you should specify a score logging
  2573.           file on the local drive of each PC, and collect these files at a
  2574.           later time. Otherwise, you may end up with a corrupted score
  2575.           file.
  2576.  
  2577.           All score log records are plain ASCII (except when encryption is
  2578.           selected). An example is reproduced below.
  2579.  
  2580.  
  2581.  
  2582.  
  2583.  
  2584.  
  2585.  
  2586.  
  2587.  
  2588.  
  2589.  
  2590.  
  2591.  
  2592.  
  2593.  
  2594.  
  2595.  
  2596.  
  2597.  
  2598.           Copyright (C) 1988-1993 Harold J. Endresen, Quid Pro Quo Software
  2599.  
  2600.  
  2601.  
  2602.           Q&A Study Aid V4.1 User's Guide                                41
  2603.  
  2604.  
  2605.           Student Name:       John Q. Public
  2606.           Database Name:      QASA Sample Database
  2607.           Final Score:        72.41%
  2608.           Grade:              C
  2609.           Termination:        TIME LIMIT
  2610.  
  2611.           Started:            Monday, July 31, 1992, 15:44:44
  2612.           Completed:          Monday, July 31, 1992, 15:46:45
  2613.           Elapsed Time:       00:02:00
  2614.  
  2615.           Database File:      SAMPLE.QA
  2616.           Total Questions:    20
  2617.           Possible Points:    29
  2618.           Points Awarded:     21
  2619.  
  2620.           Point Matrix:
  2621.                         1    2    3     4     5    6    7     8     9    10
  2622.           0001-0010 10.34 3.45 3.45   ???  3.45  ---  ???   ---  3.45  3.45
  2623.           0011-0020  6.90 3.45 6.90  3.45   --- 3.45 3.45  6.90  3.45  6.90
  2624.  
  2625.           *****************************************************************
  2626.  
  2627.  
  2628.           The '***..***' forms a separator between individual records.
  2629.  
  2630.           The first block contains summary information regarding the quiz
  2631.           session. The quiz taker's name is listed along with the name of
  2632.           the database (given by the N= keyword), the final score, the
  2633.           letter-grade equivalent (or "n/a" if none were assigned), and the
  2634.           reason the score record was written to the score file. In this
  2635.           example, it is given as 'TIME LIMIT'. This means that the quiz
  2636.           taker used up the time allotted by the T= keyword. The possible
  2637.           reasons for termination are:
  2638.  
  2639.                Completed      The user answered all questions (and option-
  2640.                               ally, within the time allotted by the T=
  2641.                               keyword).
  2642.  
  2643.                TIME LIMIT     The user exceeded the time allotted by the T=
  2644.                               keyword. This reason can only be produced if
  2645.                               a time limit was given.
  2646.  
  2647.                ABORTED        This indicates that the user quit the QASA or
  2648.                               QA session before answering all questions
  2649.                               using the /FX command or by pressing Control-
  2650.                               C or Control-Break.
  2651.  
  2652.                CLEARED        The Clear command (/MC) was used to clear the
  2653.                               score and restart the quiz. This reason can-
  2654.  
  2655.  
  2656.  
  2657.           Copyright (C) 1988-1993 Harold J. Endresen, Quid Pro Quo Software
  2658.  
  2659.  
  2660.  
  2661.           Q&A Study Aid V4.1 User's Guide                                42
  2662.  
  2663.  
  2664.                               not be produced if the C= keyword is used to
  2665.                               disable the Clear command.
  2666.  
  2667.                RELOADED       The user reloaded the database, or loaded a
  2668.                               different database, or continued a previous-
  2669.                               ly-saved database before all questions were
  2670.                               answered.
  2671.  
  2672.           The final score is always the ratio of the number of possible
  2673.           points to the total number of points awarded by answering cor-
  2674.           rectly. Questions that were not answered are scored as incorrect.
  2675.  
  2676.           The score file record also specifies the time the database was
  2677.           loaded (thereby starting the timer, if a time limit was given),
  2678.           the time the quiz was completed or stopped (for any of the
  2679.           reasons given above), and the elapsed time.
  2680.  
  2681.           The third block of the record gives the name of the compiled
  2682.           database file, the number of questions in the file, and the
  2683.           number of possible points with the number of points awarded.
  2684.           Because QASA supports weighting, the number of possible points
  2685.           may be entirely different from the number of questions.
  2686.  
  2687.           The last block is the point matrix. This shows the results of
  2688.           each question in the database, ten questions per line. Each
  2689.           question may have one of four possible outcomes:
  2690.  
  2691.                1.   The question was answered, and answered correctly. The
  2692.                     point matrix will show the number of points awarded as
  2693.                     a ratio of the number of possible points, relative to
  2694.                     100.
  2695.  
  2696.                2.   The question was answered, but answered incorrectly.
  2697.                     The point matrix will show that no points were awarded
  2698.                     with '---'.
  2699.  
  2700.                3.   The question was not answered, either by skipping over
  2701.                     it or by exceeding the allotted time. The point matrix
  2702.                     will show this with '???'. No points were awarded.
  2703.  
  2704.                4.   The point matrix entry for the question is completely
  2705.                     blank, which means that it was omitted from a subset
  2706.                     generated from the full database. In this case, the
  2707.                     question was not considered at all, in any calcula-
  2708.                     tions.
  2709.  
  2710.           In the example score record shown, you can see that questions 6,
  2711.           8, and 15 were answered incorrectly, questions 4 and 7 were not
  2712.           answered (most likely due to the time limit given as the reason),
  2713.  
  2714.  
  2715.  
  2716.           Copyright (C) 1988-1993 Harold J. Endresen, Quid Pro Quo Software
  2717.  
  2718.  
  2719.  
  2720.           Q&A Study Aid V4.1 User's Guide                                43
  2721.  
  2722.  
  2723.           and the remaining 15 questions were answered correctly. The point
  2724.           breakdown will be described in the section on weighting.
  2725.  
  2726.  
  2727.           The E= Keyword
  2728.           --------------
  2729.  
  2730.           This keyword is used to instruct QASA that the score file is to
  2731.           be encrypted. This prevents a user from completing a quiz session
  2732.           and then editing the score file manually to increase the score.
  2733.  
  2734.           When this keyword is used, the score file will not be human-
  2735.           readable, and must be converted back to plain text. This is done
  2736.           using the /UD (Utilities/Decrypt score file) command. This
  2737.           command, which is password-protected, will restore the score file
  2738.           to plain text using the same file name. If the score file is, or
  2739.           has already been converted to plain text, /UD will not reprocess
  2740.           it.
  2741.  
  2742.           If you enter the E= keyword anywhere in the database definition
  2743.           file, QASA will set a global flag that encrypts the entire score
  2744.           file.
  2745.  
  2746.  
  2747.           The D= Keyword
  2748.           --------------
  2749.  
  2750.           This keyword is used to disable the display of the correct answer
  2751.           if a question is answered incorrectly. If omitted, QASA or QA
  2752.           will display
  2753.  
  2754.                            Incorrect. The correct answer is
  2755.                                    (Correct Answer)
  2756.                               Press any key to continue
  2757.  
  2758.           The syntax of the D= keyword is as follows:
  2759.  
  2760.           D=
  2761.  
  2762.           If you enter the D= keyword anywhere in the database definition
  2763.           file, QASA will set a global flag that disables this display.
  2764.           QASA/QA will go on to the next question as though the answer was
  2765.           correct.
  2766.  
  2767.  
  2768.           The W= Keyword
  2769.           --------------
  2770.  
  2771.           This keyword is used to assign weights to each question. The
  2772.           weighting system you use is entirely arbitrary and up to you.
  2773.  
  2774.  
  2775.           Copyright (C) 1988-1993 Harold J. Endresen, Quid Pro Quo Software
  2776.  
  2777.  
  2778.  
  2779.           Q&A Study Aid V4.1 User's Guide                                44
  2780.  
  2781.  
  2782.           QASA imposes only the restriction that you use integer weights,
  2783.           and that you use numbers between 0 and 16383, inclusive.
  2784.  
  2785.           The syntax of the W= keyword is as follows:
  2786.  
  2787.           W=
  2788.           <weight>
  2789.  
  2790.           When QASA encounters this keyword, it reads the weight and
  2791.           assigns it to all the questions that follow it. If QASA encoun-
  2792.           ters the W= keyword again, it will change the weight to the new
  2793.           weight, and assign the new weight to all following questions. As
  2794.           each question is processed by the QASA compiler, QASA keeps track
  2795.           of the total weight. When QASA scores a question, it determines
  2796.           the point score to be the ratio of the total weight to that of
  2797.           the question in percent. This point score is added to the running
  2798.           score shown in the scoring window, and also appears in the point
  2799.           matrix in the score file (actually, the point score is recalcu-
  2800.           lated after each question from the weights to avoid rounding
  2801.           errors).
  2802.  
  2803.           If you do not specify a weight anywhere in the database defini-
  2804.           tion file, all questions will be weighted as one point by de-
  2805.           fault.
  2806.  
  2807.           Note that this arrangement allows you total flexibility in
  2808.           setting up a weighting system. You do not have to weight each
  2809.           question as a fraction of 100, for example. QASA does this for
  2810.           you.
  2811.  
  2812.           The sample database weights each 'fill-in' question as three
  2813.           points, each true/false as 2 points, and each multiple-choice
  2814.           question as one point. There is one 'fill-in' question, 7 'true-
  2815.           false' questions, and 12 'multiple-choice' questions. The points
  2816.           are calculated as follows:
  2817.  
  2818.                fill-in             1    times     3 points  =    3 points
  2819.                true/false          7    times     2 points  =    14 points
  2820.                multiple-choice     12   times     1 point   =    12 points
  2821.                                    -------------------------------------
  2822.                Totals:             20 questions                  29 points
  2823.  
  2824.           There are therefore 29 possible points (as shown in the score
  2825.           file). A 'fill-in' question is worth 3/29 points or 10.34 points
  2826.           relative to 100. A 'true/false' question is worth 2/29 points or
  2827.           6.90 points relative to 100, and a 'multiple-choice' question
  2828.           1/29 or 3.45 points relative to 100. In the example score record,
  2829.           the user was awarded a total of 21 out of 29 possible points, for
  2830.           a score of 21/29 or 72.41%. Adding all of the points shown in the
  2831.           point matrix will produce the same result (there may be a slight
  2832.  
  2833.  
  2834.           Copyright (C) 1988-1993 Harold J. Endresen, Quid Pro Quo Software
  2835.  
  2836.  
  2837.  
  2838.           Q&A Study Aid V4.1 User's Guide                                45
  2839.  
  2840.  
  2841.           difference due to rounding, which is done only when the scores
  2842.           are displayed).
  2843.  
  2844.           QASA also allows you to assign a weight of zero to one or any
  2845.           number of questions. These questions will not affect the score,
  2846.           as the score for any question is the ratio of the total weight of
  2847.           all questions to the weight of the question being scored. If you
  2848.           assign a weight of zero to all questions, the score will always
  2849.           be zero.
  2850.  
  2851.  
  2852.           The L= Keyword
  2853.           --------------
  2854.  
  2855.           The Limit keyword command allows you to specify to the QASA
  2856.           compiler that it is to create a subset of the database. The
  2857.           syntax is as follows:
  2858.  
  2859.           L=
  2860.           <number of questions>
  2861.  
  2862.           The sample database contains 25 questions, and also contains the
  2863.           L= keyword to limit the database to 20 of the possible 25 ques-
  2864.           tions. The QASA compiler chooses the 20 questions at random.
  2865.  
  2866.           When a subset database is created and executed, there are two
  2867.           possible times when the subset selection may be made: (1) when
  2868.           the database is compiled, in which case the compiler makes the
  2869.           choices, and (2) at run-time, when the database is loaded, in
  2870.           which case it is the QASA or QA interpreter that selects the
  2871.           subset.
  2872.  
  2873.           If QASA is being used by a single individual, it makes little
  2874.           difference when the selections are made. In a classroom environ-
  2875.           ment, however, the difference is substantial.
  2876.  
  2877.           In a classroom environment, or any environment where more than
  2878.           one person is taking a quiz using QASA (or QA), a database where
  2879.           the subset is chosen at compile time will result in each person
  2880.           being asked exactly the same set of questions. This is useful for
  2881.           generating a random class quiz, for example.
  2882.  
  2883.           However, if the choice is deferred until run time, then each
  2884.           person will be asked the same number of questions, but each
  2885.           person will be taking a quiz that may be entirely different from
  2886.           all the others. If the database contains questions of varying
  2887.           difficulty, some will be given 'easy' questions, while others may
  2888.           receive 'hard' ones.
  2889.  
  2890.  
  2891.  
  2892.  
  2893.           Copyright (C) 1988-1993 Harold J. Endresen, Quid Pro Quo Software
  2894.  
  2895.  
  2896.  
  2897.           Q&A Study Aid V4.1 User's Guide                                46
  2898.  
  2899.  
  2900.           The choice of when to generate the random subset is performed by
  2901.           the O= keyword described below.
  2902.  
  2903.  
  2904.           The O= Keyword
  2905.           --------------
  2906.  
  2907.           This keyword is used to define when the random subset of the
  2908.           database defined by the L= keyword is generated. If the L=
  2909.           keyword is not specified, this keyword will have no effect. It
  2910.           may be given before or after the L= keyword.
  2911.  
  2912.           If specified, O= means Omit immediately; in other words, omit the
  2913.           questions that are not a part of the random subset at compile
  2914.           time.
  2915.  
  2916.  
  2917.           Conclusion
  2918.           ----------
  2919.  
  2920.           Most of these examples can be found in the sample database
  2921.           definition file, SAMPLE.DEF. Experiment with it (remember to
  2922.           recompile it with QASA if you change it), but please don't pass
  2923.           on a modified copy to someone else.
  2924.  
  2925.                                      Hal Endresen
  2926.  
  2927.  
  2928.  
  2929.  
  2930.  
  2931.  
  2932.  
  2933.  
  2934.  
  2935.  
  2936.  
  2937.  
  2938.  
  2939.  
  2940.  
  2941.  
  2942.  
  2943.  
  2944.  
  2945.  
  2946.  
  2947.  
  2948.  
  2949.  
  2950.  
  2951.  
  2952.           Copyright (C) 1988-1993 Harold J. Endresen, Quid Pro Quo Software
  2953.  
  2954.  
  2955.  
  2956.           Q&A Study Aid V4.1 User's Guide                                47
  2957.  
  2958.  
  2959.  
  2960.                        Appendix A: QASA Compiler Error Messages
  2961.                        ----------------------------------------
  2962.  
  2963.           Illegal definition filename: <filename>
  2964.  
  2965.                This error is generated if you supply a database definition
  2966.                file with an extension of .QA.
  2967.  
  2968.           Cannot find database definition file <filename>
  2969.  
  2970.                This error indicates that QASA was not able to open the
  2971.                database definition file you specified.
  2972.  
  2973.           Unable to create temporary file <filename>
  2974.  
  2975.                This error indicates that QASA was not able to create its
  2976.                intermediate temporary file.
  2977.  
  2978.           File <def file> : Line <line> : Answer omitted
  2979.  
  2980.                You specified a question without an accompanying answer, or
  2981.                your syntax is such that QASA could not determine where the
  2982.                answer is.
  2983.  
  2984.           File <def file> : Line <line> : Question omitted
  2985.  
  2986.                You specified an answer without a preceding question, or
  2987.                your syntax was such that QASA could not locate the ques-
  2988.                tion.
  2989.  
  2990.           File <def file> : Line <line> : Macro name missing
  2991.  
  2992.                You specified a macro definition (M=), but the next line is
  2993.                blank.
  2994.  
  2995.           File <def file> : Line <line> : Weight definition missing
  2996.  
  2997.                You specified weighting (W=), but the next line is blank.
  2998.  
  2999.           File <def file> : Line <line> : Invalid weight
  3000.  
  3001.                You specified a weight that was outside the range 1..32767
  3002.                or entered non-numeric characters.
  3003.  
  3004.           File <def file> : Line <line> : Title missing
  3005.  
  3006.                You specified the name keyword N=, but the next line is
  3007.                blank.
  3008.  
  3009.  
  3010.  
  3011.           Copyright (C) 1988-1993 Harold J. Endresen, Quid Pro Quo Software
  3012.  
  3013.  
  3014.  
  3015.           Q&A Study Aid V4.1 User's Guide                                48
  3016.  
  3017.  
  3018.           File <def file> : Line <line> : Title too long - truncated
  3019.  
  3020.                The name you entered after the N= keyword is longer than 60
  3021.                characters.
  3022.  
  3023.           File <def file> : Line <line> : Time limit definition missing
  3024.  
  3025.                You specified the time limit keyword T=, but the next line
  3026.                is blank.
  3027.  
  3028.           File <def file> : Line <line> : Invalid time limit
  3029.  
  3030.                The time limit you specified following the T= keyword is not
  3031.                in the form HH:MM:SS.
  3032.  
  3033.           File <def file> : Line <line> : Mode lock already set
  3034.  
  3035.                You specified S= and R= in the same definition file. QASA is
  3036.                complaining about the second occurrence.
  3037.  
  3038.           File <def file> : Line <line> : Filename missing
  3039.  
  3040.                You specified an output score file with the F= keyword, but
  3041.                the next line is blank.
  3042.  
  3043.           File <def file> : Line <line> : Illegal filename
  3044.  
  3045.                You specified a filename after the F= keyword that has
  3046.                invalid characters or longer than 64 characters.
  3047.  
  3048.           File <def file> : Line <line> : Question line exceeds <nn>
  3049.           characters
  3050.  
  3051.                You entered a line in a question block that will not fit
  3052.                into QASA's window.
  3053.  
  3054.           File <def file> : Line <line> : Question exceeds <nn> lines
  3055.  
  3056.                You entered a question that has too many lines.
  3057.  
  3058.           File <def file> : Line <line> : Answer line exceeds <nn> charac-
  3059.           ters
  3060.  
  3061.                You entered an answer line that will not fit into QASA's
  3062.                answer window.
  3063.  
  3064.           Cannot create database output file <filename>
  3065.  
  3066.                QASA was unable to create the compiled database output file.
  3067.  
  3068.  
  3069.  
  3070.           Copyright (C) 1988-1993 Harold J. Endresen, Quid Pro Quo Software
  3071.  
  3072.  
  3073.  
  3074.           Q&A Study Aid V4.1 User's Guide                                49
  3075.  
  3076.  
  3077.           Cannot open temporary file <filename>
  3078.  
  3079.                QASA was unable to create its temporary file.
  3080.  
  3081.           File <def file> : Line <line> : Macro <name> is self-referential
  3082.  
  3083.                The macro specified is self-referential. This may be a
  3084.                direct self-referencing macro or it may occur as a result of
  3085.                a complex series of recursive, circular macro expansions.
  3086.  
  3087.  
  3088.  
  3089.  
  3090.  
  3091.  
  3092.  
  3093.  
  3094.  
  3095.  
  3096.  
  3097.  
  3098.  
  3099.  
  3100.  
  3101.  
  3102.  
  3103.  
  3104.  
  3105.  
  3106.  
  3107.  
  3108.  
  3109.  
  3110.  
  3111.  
  3112.  
  3113.  
  3114.  
  3115.  
  3116.  
  3117.  
  3118.  
  3119.  
  3120.  
  3121.  
  3122.  
  3123.  
  3124.  
  3125.  
  3126.  
  3127.  
  3128.  
  3129.           Copyright (C) 1988-1993 Harold J. Endresen, Quid Pro Quo Software
  3130.  
  3131.  
  3132.  
  3133.           Q&A Study Aid V4.1 User's Guide                                50
  3134.  
  3135.  
  3136.  
  3137.                            Appendix B: Revision Information
  3138.                            --------------------------------
  3139.  
  3140.           Version 4.1    January 17, 1993
  3141.  
  3142.                Beginning with Version 4.1, QASA can be registered online
  3143.                via CompuServe. GO SWREG and register ID # 502.
  3144.  
  3145.                Modified the registration screen so that if 200 or more
  3146.                copies are specified, a site license is automatically grant-
  3147.                ed.
  3148.  
  3149.           Version 4.0    December 1, 1992
  3150.  
  3151.                Version 4.0 incorporates many of the changes and improve-
  3152.                ments that have been suggested by various users of Q&A Study
  3153.                Aid. Two significant features have been added in this ver-
  3154.                sion:
  3155.  
  3156.                (1)  A separate program, QA.EXE, is included with the Q&A
  3157.                     Study Aid package. This program is essentially the
  3158.                     QASA.EXE program without the quiz creation capabili-
  3159.                     ties. It has only a single menu for simple operation.
  3160.                     Its purpose is to enable you to give tests and quizzes
  3161.                     without confusing the test takers with the many options
  3162.                     available with QASA.EXE.
  3163.  
  3164.                     QA.EXE is not serialized and does not attempt to modify
  3165.                     itself at any time; this permits it to be executed in a
  3166.                     DOS screen under OS/2 2.0.
  3167.  
  3168.                     Also, if the name of a quiz is specified on the command
  3169.                     line (or in a batch file), then QA.EXE will automati-
  3170.                     cally terminate, returning control to DOS when the quiz
  3171.                     is completed (or terminated for any reason). This
  3172.                     feature permits one to complete a quiz session without
  3173.                     using any commands or menu functions at all.
  3174.  
  3175.                (2)  QASA.EXE is now able to generate a subset of a data-
  3176.                     base. For example, if you create a database containing
  3177.                     50 questions, you can specify that QASA generate a
  3178.                     database containing only 25 questions, chosen at ran-
  3179.                     dom. You may select the size of the subset to be any-
  3180.                     thing from 1 up to the full size of the database.
  3181.  
  3182.                     Further, the random selection of questions may be
  3183.                     specified to occur at one of two times: during the
  3184.                     compilation process, or when the database is loaded.
  3185.                     Making the selection at compile time allows each stu-
  3186.  
  3187.  
  3188.           Copyright (C) 1988-1993 Harold J. Endresen, Quid Pro Quo Software
  3189.  
  3190.  
  3191.  
  3192.           Q&A Study Aid V4.1 User's Guide                                51
  3193.  
  3194.  
  3195.                     dent to receive the same database. If the selection is
  3196.                     deferred until run time, then each student will receive
  3197.                     a unique and different subset of the database. Each
  3198.                     student will, however, be given the same number of
  3199.                     questions to answer.
  3200.  
  3201.                     Two new command keywords, "L=" and "O=", are used to
  3202.                     control the creation of database subsets.
  3203.  
  3204.                The naming conventions have been changed in version 4.0.
  3205.                Specifically, the ampersand ('&') has been removed from all
  3206.                filenames, as some operating systems (DEC's VMS and IBM's
  3207.                OS/2 are two) cannot tolerate this character within a file-
  3208.                name. CompuServe cannot tolerate an ampersand either. Also,
  3209.                the filenames have been shortened to six characters instead
  3210.                of the eight allowed by DOS, again to accommodate other
  3211.                operating systems. These changes insure that Q&A Study Aid
  3212.                will have the same filename from all sources.
  3213.  
  3214.           Version 3.91   April 26, 1992
  3215.  
  3216.                Added the /UR (Utilities/print Registration form) command.
  3217.                This command prompts for all of the information needed to
  3218.                register Q&A Study Aid, and prints a form ready to mail,
  3219.                complete with computations showing pricing. This feature
  3220.                also determines many of the more important features of your
  3221.                computer system so that this information is available should
  3222.                you require assistance.
  3223.  
  3224.                Added the file VENDOR.DOC for vendors and BBS Sysops.
  3225.  
  3226.           Version 3.90   September 1, 1991
  3227.  
  3228.                Fixed a major bug that caused questions to be skipped in
  3229.                both sequential and random modes. All questions are now
  3230.                properly presented in either mode. Thanks to a concerned
  3231.                user in Pennsylvania for reporting this error.
  3232.  
  3233.                Integrated all auxiliary programs into the main program
  3234.                file. There is now only one program. Access to the compiler
  3235.                and other functions related to the score file is now by
  3236.                password access.
  3237.  
  3238.                Added a secure password function. Q&ASA is distributed
  3239.                without a password. To enable password protection, you must
  3240.                enter a password.
  3241.  
  3242.                Added the ability to export certain fields of the score file
  3243.                in a form suitable for importing into other spreadsheet and
  3244.                database programs.
  3245.  
  3246.  
  3247.           Copyright (C) 1988-1993 Harold J. Endresen, Quid Pro Quo Software
  3248.  
  3249.  
  3250.  
  3251.           Q&A Study Aid V4.1 User's Guide                                52
  3252.  
  3253.  
  3254.                Added the ability to associate "letter grades" to scores.
  3255.                Letter grades consist of any string up to five characters in
  3256.                length. This permits the use of an A..F grading system, or
  3257.                the GPA grading system used in colleges and universities;
  3258.                e.g., 4.0 and down, or even "PASS/FAIL". There is no defined
  3259.                limit on the number of associations between scores and
  3260.                letter grades.
  3261.  
  3262.                Added the ability to exclude all punctuation from an answer
  3263.                list and from the user's response. This allows the answer
  3264.                list to be shorter, and permits numbers with commas to be
  3265.                scored correctly if the commas are omitted.
  3266.  
  3267.                Added code to detect self-referential macros, now matter how
  3268.                deeply recursive the nesting may be. Q&ASA can no longer
  3269.                crash if self-referential macros are inadvertently speci-
  3270.                fied.
  3271.  
  3272.                Added a test to lock out the /N (Name) command once a data-
  3273.                base with score file logging has been loaded and a name has
  3274.                been entered. This prevents a user from changing his or her
  3275.                name if the score is low.
  3276.  
  3277.                Added the "Utilities" menu that provides access to the pass-
  3278.                word-setting function, the compiler, score file utilities,
  3279.                menu selector character, and color selection, as follows:
  3280.  
  3281.                     o    The /UM command sets the menu selector character.
  3282.                     o    The /US command sets the screen colors.
  3283.                     o    The /UP command sets the password.
  3284.                     o    The /UC command executes the compiler.
  3285.                     o    The /UD command is used to convert an encrypted
  3286.                          score file to plain text.
  3287.                     o    The /UE command is used to export a score file in
  3288.                          a format suitable for use with other database and
  3289.                          spreadsheet programs.
  3290.  
  3291.                Recompiled Q&ASA using the large data model. In a system
  3292.                with 512K bytes of memory available after booting, Q&ASA can
  3293.                now accommodate some 40,000 questions and their answers.
  3294.                Internal overlays are used to keep the size of executable
  3295.                memory image to a minimum.
  3296.  
  3297.                Q&ASA is now "DESQview aware" and will properly execute
  3298.                within a DESQview window.
  3299.  
  3300.                Added a command to "shell" to DOS for access to an editor or
  3301.                other program from within Q&ASA.
  3302.  
  3303.  
  3304.  
  3305.  
  3306.           Copyright (C) 1988-1993 Harold J. Endresen, Quid Pro Quo Software
  3307.  
  3308.  
  3309.  
  3310.           Q&A Study Aid V4.1 User's Guide                                53
  3311.  
  3312.  
  3313.                The /FS (File/Save Database) command no longer causes an
  3314.                immediate exit to DOS. You may therefore save a database in
  3315.                progress and then load another one.
  3316.  
  3317.           Version 3.80   August 4, 1990
  3318.  
  3319.                Changed Mode/Random from /MA to /MR.
  3320.  
  3321.                Eliminated the screen control menu.
  3322.  
  3323.                Left-justified the mode in the status window.
  3324.  
  3325.                Added a check to insure that the screen is free before
  3326.                updating the time left.
  3327.  
  3328.                Recompiled with aggressive optimizations using the new
  3329.                version (V6.0) of the Microsoft C Optimizing Compiler. The
  3330.                .EXE file size has been significantly reduced.
  3331.  
  3332.           Version 3.70   December 30, 1989
  3333.  
  3334.                Fixed a major bug that caused all screen attributes to be
  3335.                set to zero if the configuration file was missing. Since the
  3336.                configuration file is not distributed with Q&A Study Aid,
  3337.                the effect was to present a blank screen. Although commands
  3338.                could be entered and the screen colors set, all of this had
  3339.                to be done with a blank screen.
  3340.  
  3341.                Also fixed a bug in the answer screen that would not allow
  3342.                an altered menu-select character to be used to escape into
  3343.                the menu system. This bug was reported by a concerned user;
  3344.                our thanks go out to him.
  3345.  
  3346.           Version 3.60   December 10, 1989
  3347.  
  3348.                A potential problem was found and corrected with the calcu-
  3349.                lation of weights. This problem would be encountered only if
  3350.                the total weight exceeded 32767, which is the maximum weight
  3351.                permitted.
  3352.  
  3353.                The /FS (File/Save Database) and /FC (File/Continue Data-
  3354.                base) commands were added. This combination allows the user
  3355.                of Q&ASA to save the current state of a test or quiz data-
  3356.                base and return to it later. The database will be restored
  3357.                to its previous state. These commands will not work if the
  3358.                database has a time limit associated with it.
  3359.  
  3360.                The "E=" option has been added to the database compiler
  3361.                Q&AC.EXE. This option specifies that the score file is to be
  3362.                encrypted so that a user cannot complete a test or quiz, and
  3363.  
  3364.  
  3365.           Copyright (C) 1988-1993 Harold J. Endresen, Quid Pro Quo Software
  3366.  
  3367.  
  3368.  
  3369.           Q&A Study Aid V4.1 User's Guide                                54
  3370.  
  3371.  
  3372.                then edit the resulting score in the score file. A new
  3373.                utility, Q&AD.EXE, restores the score file to plain ASCII
  3374.                text.
  3375.  
  3376.                A configuration file was added. This file must be located in
  3377.                the same directory as the help file Q&ASA.HLP, and the same
  3378.                rules that govern its access apply to the configuration
  3379.                file. The configuration file is named Q&ASA.CFG. It is not
  3380.                included in the distribution, since Q&ASA will automatically
  3381.                create it the first time it is executed.
  3382.  
  3383.                A new command, /FE, allows the screen colors to be changed.
  3384.                The new values are saved in the configuration file.
  3385.  
  3386.                A new command, /FM, allows the menu selector character to be
  3387.                altered. This defaults to the forward slash character ('/'),
  3388.                but may now be changed to any other character in the print-
  3389.                able ASCII range of '!' through '~', inclusive. Once
  3390.                changed, the new selector character is saved in the configu-
  3391.                ration file so the effect of the change will be permanent
  3392.                unless changed again.
  3393.  
  3394.                The weighting system was altered to permit questions to have
  3395.                a weight of zero. If desired, all questions may be weighted
  3396.                as zero, but this will cause all scores to be zero also.
  3397.  
  3398.           Version 3.50   August 10, 1989
  3399.  
  3400.                The menu was modified to eliminate the /FD and /FS commands,
  3401.                which were replaced with the single command /FL (File/Load
  3402.                Database). The directory defaults to the current working
  3403.                directory. The directory may be changed if desired.
  3404.  
  3405.                Major internal enhancements were made to the video system.
  3406.                Q&ASA will now detect the type of display adapter in use,
  3407.                and will operate properly with 132-column and 43- and 50-
  3408.                line modes. The screen update rate has been increased. The
  3409.                /S? commands are necessary only in extreme cases where snow
  3410.                is a severe problem (these commands have been retained,
  3411.                however). Q&ASA will now autoselect the screen update meth-
  3412.                od.
  3413.  
  3414.                The registration functions have been entirely replaced. The
  3415.                new registration system now sets the executable file to
  3416.                read-only to prevent inadvertent overwriting of the execut-
  3417.                able image. The serial number now provides certain essential
  3418.                information about the system Q&ASA is running on. Q&ASA will
  3419.                detect certain changes to itself and refuse to execute if it
  3420.                is modified. A demonstration mode has been added (although
  3421.  
  3422.  
  3423.  
  3424.           Copyright (C) 1988-1993 Harold J. Endresen, Quid Pro Quo Software
  3425.  
  3426.  
  3427.  
  3428.           Q&A Study Aid V4.1 User's Guide                                55
  3429.  
  3430.  
  3431.                the program is not distributed as a demo; it is a full-
  3432.                featured program with no crippling of any function).
  3433.  
  3434.                Q&ASA now intercepts the Control-C and Control-Break keys
  3435.                and will perform a graceful exit with proper updating of the
  3436.                score file. Hardware error detection and handling of criti-
  3437.                cal errors has been improved, and now offers the options of
  3438.                Retry or Cancel (Cancel aborts only the command that experi-
  3439.                enced the error, not the program as a whole).
  3440.  
  3441.                The Help key (F1) is now active in the opening screen. You
  3442.                may obtain an overview of the operation of Q&ASA at the
  3443.                opening screen, or exit the program by pressing ESCape.
  3444.                Several new categories have been added to the help file for
  3445.                registering and for reporting problems.
  3446.  
  3447.           Version 3.1    July 31, 1989
  3448.  
  3449.                Made some minor corrections and additions to this manual,
  3450.                and corrected a minor bug related to locating the executable
  3451.                file on disk.
  3452.  
  3453.           Version 3.0    May 1, 1989
  3454.  
  3455.                Corrected a bug in the random mode termination function, and
  3456.                enhanced the random mode search speed. Version 2.1 would
  3457.                continue to ask questions after they had been answered,
  3458.                allowing a user to gain a score exceeding 100%. Also en-
  3459.                hanced the registration function.
  3460.  
  3461.                o    Added the 'D=' command to Q&AC and Q&ASA to allow the
  3462.                     database author to disable display of the correct
  3463.                     answer if the user answers incorrectly.
  3464.                o    Added the ability to specify and execute a database
  3465.                     from the DOS command line.
  3466.  
  3467.           Version 2.1    July 31, 1988
  3468.  
  3469.                Minor enhancements to help system.
  3470.  
  3471.           Version 2.0    March 22, 1988
  3472.  
  3473.                Major enhancements to allow Q&ASA to be used in a formal
  3474.                classroom environment. Among the changes are the following:
  3475.  
  3476.                o    Optional logging of scoring information to a disk file.
  3477.                o    Compiled database eliminates run-time interpreter
  3478.                     errors and permits the database to be encrypted.
  3479.                o    Display of the database name as the window title.
  3480.                o    Faster response when loading questions.
  3481.  
  3482.  
  3483.           Copyright (C) 1988-1993 Harold J. Endresen, Quid Pro Quo Software
  3484.  
  3485.  
  3486.  
  3487.           Q&A Study Aid V4.1 User's Guide                                56
  3488.  
  3489.  
  3490.                o    Greatly improved help system allows selection and
  3491.                     viewing of any help category at any time.
  3492.                o    Optional locking of selected mode and lockout of cer-
  3493.                     tain commands.
  3494.                o    Ability to assign a weight to each question and have
  3495.                     this weight determine the number of points awarded for
  3496.                     a correct answer to a question.
  3497.                o    Ability to specify a time limit to answer all ques-
  3498.                     tions.
  3499.                o    Elimination of all index files.
  3500.  
  3501.           Version 1.0    January 7, 1988
  3502.  
  3503.                Initial public release.
  3504.  
  3505.  
  3506.  
  3507.  
  3508.  
  3509.  
  3510.  
  3511.  
  3512.  
  3513.  
  3514.  
  3515.  
  3516.  
  3517.  
  3518.  
  3519.  
  3520.  
  3521.  
  3522.  
  3523.  
  3524.  
  3525.  
  3526.  
  3527.  
  3528.  
  3529.  
  3530.  
  3531.  
  3532.  
  3533.  
  3534.  
  3535.  
  3536.  
  3537.  
  3538.  
  3539.  
  3540.  
  3541.  
  3542.           Copyright (C) 1988-1993 Harold J. Endresen, Quid Pro Quo Software
  3543.  
  3544.  
  3545.  
  3546.           Q&A Study Aid V4.1 User's Guide                                57
  3547.  
  3548.  
  3549.                                       COPYRIGHT
  3550.                                       ---------
  3551.  
  3552.           This program is copyright (C) 1988, 1989, 1990, 1991, 1992, 1993
  3553.           by Harold J. Endresen, Quid Pro Quo Software. All rights reserved
  3554.           worldwide.
  3555.  
  3556.           Q&A Study Aid is distributed as SHAREWARE, or User-Supported
  3557.           Software. You are encouraged to try the program and share it with
  3558.           others, provided that:
  3559.  
  3560.                The program is distributed in unmodified form as the com-
  3561.                plete archive QASA41.ZIP, complete with documentation and
  3562.                the registration information on the following pages.
  3563.  
  3564.                No fee, charge or other consideration is requested or ac-
  3565.                cepted (a nominal reproduction fee is acceptable if dis-
  3566.                kettes or CD-ROMs are the distribution medium, provided no
  3567.                charge is specified or required for the program itself).
  3568.  
  3569.                The program is not distributed in conjunction with any other
  3570.                product.
  3571.  
  3572.  
  3573.  
  3574.  
  3575.  
  3576.  
  3577.  
  3578.  
  3579.  
  3580.  
  3581.  
  3582.  
  3583.  
  3584.  
  3585.  
  3586.  
  3587.  
  3588.  
  3589.  
  3590.  
  3591.  
  3592.  
  3593.  
  3594.  
  3595.  
  3596.  
  3597.  
  3598.  
  3599.  
  3600.  
  3601.           Copyright (C) 1988-1993 Harold J. Endresen, Quid Pro Quo Software
  3602.  
  3603.  
  3604.  
  3605.           Q&A Study Aid V4.1 User's Guide                                58
  3606.  
  3607.  
  3608.  
  3609.                                 DISCLAIMER - AGREEMENT
  3610.                                 ----------------------
  3611.  
  3612.           Users of Q&A Study Aid must accept this disclaimer of warranty:
  3613.           "Q&A Study Aid is supplied as is. The author disclaims all
  3614.           warranties, expressed or implied, including, without limitation,
  3615.           all warranties of merchantability and of fitness for any purpose.
  3616.           The author assumes no liability for damages, direct or consequen-
  3617.           tial, pecuniary or otherwise, which may result from the use of
  3618.           Q&A Study Aid."
  3619.  
  3620.           Anyone distributing Q&A Study Aid for any kind of remuneration
  3621.           MUST specify in any literature or advertising that Q&A Study Aid
  3622.           is SHAREWARE, and as such, requires registration and payment to
  3623.           the author of the program above and beyond any payment the buyer
  3624.           makes for a copy of the program on some distribution media.
  3625.  
  3626.  
  3627.  
  3628.  
  3629.  
  3630.  
  3631.  
  3632.  
  3633.  
  3634.  
  3635.  
  3636.  
  3637.  
  3638.  
  3639.  
  3640.  
  3641.  
  3642.  
  3643.  
  3644.  
  3645.  
  3646.  
  3647.  
  3648.  
  3649.  
  3650.  
  3651.  
  3652.  
  3653.  
  3654.  
  3655.  
  3656.  
  3657.  
  3658.  
  3659.  
  3660.           Copyright (C) 1988-1993 Harold J. Endresen, Quid Pro Quo Software
  3661.  
  3662.  
  3663.  
  3664.           Q&A Study Aid V4.1 User's Guide                                59
  3665.  
  3666.  
  3667.  
  3668.                                      REGISTRATION
  3669.                                      ------------
  3670.  
  3671.           Q&A Study Aid is a "shareware program" and is provided at no
  3672.           charge to the user for evaluation. Feel free to share it with
  3673.           your friends, but please do not give it away altered or as part
  3674.           of another system. The essence of "user-supported" software is to
  3675.           provide personal computer users with quality software without
  3676.           high prices, and provides an incentive for programmers to contin-
  3677.           ue to develop new products. If you find this program useful and
  3678.           find that you are using Q&A Study Aid and continue to it after a
  3679.           reasonable trial period (30 days), you must make a registration
  3680.           payment of $20.00 (US) to Quid Pro Quo Software. The $20.00
  3681.           registration fee will license one copy for use on any one comput-
  3682.           er at any one time. You must treat this software just like a
  3683.           book. An example is that this software may be used by any number
  3684.           of people and may be freely moved from one computer location to
  3685.           another, so long as there is no possibility of it being used at
  3686.           one location while it is also being used at another - just as a
  3687.           book cannot be read by two different persons at the same time.
  3688.  
  3689.           You are encouraged to pass a copy of Q&A Study Aid along to your
  3690.           friends for evaluation. Please encourage them to register their
  3691.           copy if they find the program useful and continue using it. All
  3692.           registered users will receive a copy of the latest version of the
  3693.           Q&A Study Aid system if the registration form specifies any
  3694.           version prior to the latest version, and all registered users
  3695.           will be notified of upgrades and improvements. As a registered
  3696.           user, you are also entitled to free replacement of the program
  3697.           should a maintenance release be made within a period of one year
  3698.           following your original registration.
  3699.  
  3700.           Commercial or governmental users of Q&A Study Aid must register
  3701.           and pay for their copies of Q&A Study Aid within 30 days of first
  3702.           use or their license is withdrawn. Quantity discounts apply per
  3703.           the following schedule (all prices are in US dollars):
  3704.  
  3705.                One copy                 $20.00
  3706.                Two copies               $35.00
  3707.                3-10 copies              $10.00 plus $10.00 per copy
  3708.                11-30 copies             $50.00 plus $5.00 per copy
  3709.                30-199 copies            $100.00 plus $2.00 per copy
  3710.                200+ copies              $500.00 site license
  3711.  
  3712.  
  3713.  
  3714.  
  3715.  
  3716.  
  3717.  
  3718.  
  3719.           Copyright (C) 1988-1993 Harold J. Endresen, Quid Pro Quo Software
  3720.  
  3721.  
  3722.  
  3723.           Q&A Study Aid V4.1 User's Guide                                60
  3724.  
  3725.  
  3726.  
  3727.                                     SITE LICENSING
  3728.                                     --------------
  3729.  
  3730.           Q&A Study Aid is particularly suited for a classroom environment.
  3731.           For this reason, a site license is available for the equivalent
  3732.           of 200 individual copies of Q&A Study Aid, or $500.00. A site
  3733.           license applies to a single geographical location, networked or
  3734.           not, which may consist of more than one physical structure or
  3735.           building. A site license is automatically extended to include
  3736.           multiple sites that comprise a single school, college, or univer-
  3737.           sity campus, even if these sites are not physically adjacent. A
  3738.           site license does NOT include organizational structures such as
  3739.           whole school districts, or multiple, individually-named sites of
  3740.           an entire state university system.
  3741.  
  3742.           If you would like to purchase a site license, simply specify 200
  3743.           or more copies of the Q&A Study Aid Program. This will be auto-
  3744.           matically converted to a site license at a maximum registration
  3745.           fee of $500.00. It is your responsibility to make as many physi-
  3746.           cal copies of the registered program as you require for your
  3747.           organization.
  3748.  
  3749.  
  3750.  
  3751.  
  3752.  
  3753.  
  3754.  
  3755.  
  3756.  
  3757.  
  3758.  
  3759.  
  3760.  
  3761.  
  3762.  
  3763.  
  3764.  
  3765.  
  3766.  
  3767.  
  3768.  
  3769.  
  3770.  
  3771.  
  3772.  
  3773.  
  3774.  
  3775.  
  3776.  
  3777.  
  3778.           Copyright (C) 1988-1993 Harold J. Endresen, Quid Pro Quo Software
  3779.  
  3780.  
  3781.  
  3782.           Q&A Study Aid V4.1 User's Guide                                61
  3783.  
  3784.  
  3785.  
  3786.                                     SPECIAL OFFER!
  3787.                                     --------------
  3788.  
  3789.           Registered users of Q&A Study Aid program may purchase a 1-year
  3790.           subscription to Shareware Magazine, normally $20.00, for just
  3791.           $12.95. Simply call (800) 245-6717 and give Special Order #: 2262
  3792.           in order to use Mastercard or VISA. You may also send a check for
  3793.           $12.95 to:
  3794.  
  3795.                Shareware Magazine Subscription
  3796.                1030 D E. Duane Ave.
  3797.                Sunnyvale, CA 94086
  3798.  
  3799.           Include the Special Order number along with your name and mailing
  3800.           address.
  3801.  
  3802.  
  3803.  
  3804.  
  3805.  
  3806.  
  3807.  
  3808.  
  3809.  
  3810.  
  3811.  
  3812.  
  3813.  
  3814.  
  3815.  
  3816.  
  3817.  
  3818.  
  3819.  
  3820.  
  3821.  
  3822.  
  3823.  
  3824.  
  3825.  
  3826.  
  3827.  
  3828.  
  3829.  
  3830.  
  3831.  
  3832.  
  3833.  
  3834.  
  3835.  
  3836.  
  3837.           Copyright (C) 1988-1993 Harold J. Endresen, Quid Pro Quo Software
  3838.  
  3839.  
  3840.  
  3841.           Q&A Study Aid V4.1 User's Guide                                62
  3842.  
  3843.  
  3844.  
  3845.                          Q&A STUDY AID V4.1 REGISTRATION FORM
  3846.  
  3847.           Name_____________________________________________________________
  3848.  
  3849.           Title ___________________________________________________________
  3850.  
  3851.           Company _________________________________________________________
  3852.  
  3853.           Address _________________________________________________________
  3854.  
  3855.           City __________________________________ State ______ Zip ________
  3856.  
  3857.           Country _______________________________ Phone ___________________
  3858.  
  3859.           SERIAL NUMBER FROM OPENING SCREEN _______________________________
  3860.  
  3861.           NUMBER OF COPIES DESIRED (see schedule below) ___________________
  3862.  
  3863.           Display System __________________________________________________
  3864.           DOS Version _____________________________________________________
  3865.           PC Make/Model/CPU _______________________________________________
  3866.           Fixed Disk Type/Capacity ________________________________________
  3867.           Floppy Disks ____________________________________________________
  3868.           System RAM ______________________________________________________
  3869.  
  3870.           To register, send this form and a check for the appropriate
  3871.           amount in U.S. dollars to Quid Pro Quo Software at the address
  3872.           shown below. The discount schedule is as follows:
  3873.  
  3874.                One copy                 $20.00
  3875.                Two copies               $35.00
  3876.                3-9 copies               $10.00 plus $10.00 per copy
  3877.                10-29 copies             $50.00 plus $5.00 per copy
  3878.                30-199 copies            $100.00 plus $2.00 per copy
  3879.                200+ copies              $500.00 site license
  3880.  
  3881.                                 Quid Pro Quo Software
  3882.                                     P.O. Box 1248
  3883.                              Cedar Rapids, IA 52406-1248
  3884.  
  3885.           Registered users will receive notification of upgrades of Q&A
  3886.           Study Aid, a registration number to remove the registration
  3887.           notice from the opening screen, and support either via CompuServe
  3888.           [73760,2032] or by mail. You will be entitled to maintenance
  3889.           releases for a period of one year following original registra-
  3890.           tion. Non-registered users may make inquiries as to the suitabil-
  3891.           ity of this program for their particular purpose and to report
  3892.           bugs, errors, or desired features.
  3893.  
  3894.  
  3895.  
  3896.           Copyright (C) 1988-1993 Harold J. Endresen, Quid Pro Quo Software